security/hakurei.app
security/hakurei.app
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 4 Wiki Activity

add network location docs and update related gmscompat info

Browse Source
This commit is contained in:
matchboxbananasynergy 2025-03-27 22:39:14 +00:00 committed by Daniel Micay
parent 3bc625634d
commit f6b3bb32e8
2 changed files with 70 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
static/features.html
View File

@ -103,6 +103,7 @@
<li><a href="#broad-carrier-support">Broad carrier support without invasive carrier access</a></li> <li><a href="#broad-carrier-support">Broad carrier support without invasive carrier access</a></li>
<li><a href="#lte-only-mode">LTE-only mode</a></li> <li><a href="#lte-only-mode">LTE-only mode</a></li>
<li><a href="#wifi-privacy">Wi-Fi privacy</a></li> <li><a href="#wifi-privacy">Wi-Fi privacy</a></li>
<li><a href="#network-location">Network location</a></li>
<li><a href="#private-screenshots">Private screenshots</a></li> <li><a href="#private-screenshots">Private screenshots</a></li>
<li><a href="#closed-device-identifier-leaks">Closed device identifier leaks</a></li> <li><a href="#closed-device-identifier-leaks">Closed device identifier leaks</a></li>
<li><a href="#privacy-by-default">Privacy by default</a></li> <li><a href="#privacy-by-default">Privacy by default</a></li>
@ -720,6 +721,31 @@
standard Wi-Fi privacy approach.</p> standard Wi-Fi privacy approach.</p>
</section> </section>
<section id="network-location">
<h3><a href="#network-location">Network location</a></h3>
<p>GrapheneOS provides the ability to use network location as an opt-in
feature.</p>
<p>Enabling the network location feature will make getting a location lock
indoors and in cities with tall buildings much faster, or possible when it would
have previously been impossible. Additionally, network location improves app
compatibility for apps that expect a fast location lock from the network
location provider which they won't get when it's off and GNSS is being used
instead.</p>
<p>The feature works by sending nearby Wi-Fi network identifiers to the service,
which returns positioning data for those networks and other nearby ones to store
in a temporary in-memory cache. Your location is estimated using a robust
on-device multilateration algorithm.</p>
<p>In the future, GrapheneOS plans to provide an option for offline network
location using downloaded data instead of having to send data to a service.</p>
<p>For details on how to use the network location feature, see the
<a href="/usage#network-location">usage section</a>.</p>
</section>
<section id="private-screenshots"> <section id="private-screenshots">
<h3><a href="#private-screenshots">Private screenshots</a></h3> <h3><a href="#private-screenshots">Private screenshots</a></h3>

67
static/usage.html
View File

@ -85,6 +85,7 @@
<li><a href="#wifi-privacy-associated">Associated with an Access Point (AP)</a></li> <li><a href="#wifi-privacy-associated">Associated with an Access Point (AP)</a></li>
</ul> </ul>
</li> </li>
<li><a href="#network-location">Network location</a></li>
<li><a href="#lte-only-mode">LTE-only mode</a></li> <li><a href="#lte-only-mode">LTE-only mode</a></li>
<li> <li>
<a href="#sandboxed-google-play">Sandboxed Google Play</a> <a href="#sandboxed-google-play">Sandboxed Google Play</a>
@ -967,6 +968,24 @@
</section> </section>
</section> </section>
<section id="network-location">
<h2><a href="#network-location">Network location</a></h2>
<p>For more information on the network location feature and how it works, see the
<a href="/features#network-location">features section</a>.</p>
<p>The setting can be found at <b>Settings&#160;<span aria-label="and then">></span>
Location&#160;<span aria-label="and then">></span> Location services&#160;<span
aria-label="and then">></span> Network location</b>. The available options are using
Apple's network location service, or a GrapheneOS proxy to that service.</p>
<p>To use this feature, you need to make sure that you either have Wi-Fi enabled, or that
Wi-Fi scanning is enabled at <b>Settings&#160;<span aria-label="and then">></span>
Location&#160;<span aria-label="and then">></span> Location services&#160;<span
aria-label="and then">></span> Wi-Fi scanning</b>. Enabling the Wi-Fi scanning setting
will allow you to use network location even if you disable the global Wi-Fi toggle.</p>
</section>
<section id="lte-only-mode"> <section id="lte-only-mode">
<h2><a href="#lte-only-mode">LTE-only mode</a></h2> <h2><a href="#lte-only-mode">LTE-only mode</a></h2>
@ -1027,7 +1046,9 @@
requests are rerouted to a reimplementation of the Play geolocation service requests are rerouted to a reimplementation of the Play geolocation service
provided by GrapheneOS. You can disable rerouting and use the standard Play provided by GrapheneOS. You can disable rerouting and use the standard Play
services geolocation service instead if you want the Google network location services geolocation service instead if you want the Google network location
service and related features.</p> service and related features. This shouldn't be needed outside of testing or
obscure use cases, since GrapheneOS provides its own opt-in
<a href="/features#network-location">Network Location</a> feature.</p>
<p>Our compatibility layer includes full support for the Play Store. Play Store <p>Our compatibility layer includes full support for the Play Store. Play Store
services are fully available including in-app purchases, Play Asset Delivery, Play services are fully available including in-app purchases, Play Asset Delivery, Play
@ -1090,30 +1111,30 @@
<p>By default, apps using Google Play geolocation are redirected to our own <p>By default, apps using Google Play geolocation are redirected to our own
implementation on top of the standard OS geolocation service. You don't need to implementation on top of the standard OS geolocation service. You don't need to
grant any permissions to Google Play or change any settings for working location grant any permissions to Google Play or change any settings for working location
in apps using Google Play geolocation due to our rerouting feature. If you want in apps using Google Play geolocation due to our rerouting feature.</p>
to use Google's network location service to provide location estimates without
satellite reception, you can disable the "Reroute location requests to OS APIs" <p>This is not recommended unless you're testing something or have an obscure
toggle and grant what it requires to provide network location. You will need to use case since our <a href="/features#network-location">network location</a>
grant "Allow all the time" Location access to Google Play services along with feature can be used instead, but if you want to use Google's network location
the Nearby Devices permission for it to have all the access it needs. You need service to provide location estimates without satellite reception, you can
to use the "Google Location Accuracy" link from the sandboxed Google Play follow these steps:</p>
configuration menu to access the Google Play services menu for opting into their
network location service, otherwise this is all pointless. It will send the <ol>
nearby Wi-Fi and cellular networks provided via the Location and Nearby Devices <li>Disable the "Reroute location requests to OS APIs" toggle.</li>
permissions to their service to retrieve a location estimate. In order to fully <li>Grant "Allow all the time" Location access to Google Play services along with the
take advantage of Wi-Fi and Bluetooth scanning, you also need to enable the Nearby Devices permission for it to have all the access it needs. </li>
scanning toggles in <b>Settings&#160;<span aria-label="and then">></span> <li>Use the "Google Location Accuracy" link from the sandboxed Google Play configuration
Location &#160;<span aria-label="and then">></span> Location services</b> which menu to access the Google Play services menu for opting into their network location service.</li>
are disabled by default and control whether apps with the required permissions can <li>To take advantage of Wi-Fi and Bluetooth scanning, you also need to enable the scanning
scan when Wi-Fi and Bluetooth are otherwise disabled.</p> toggles in <b>Settings&#160;<span aria-label="and then">></span>
Location &#160;<span aria-label="and then">></span> Location services</b>
which are disabled by default and control whether apps with the required permissions
can scan when Wi-Fi and Bluetooth are otherwise disabled.</li>
</ol>
<p>Re-routing location to the OS geolocation service will use more power than <p>Re-routing location to the OS geolocation service will use more power than
using the Google Play geolocation service since we do not provide a using the Google Play geolocation service unless you enable our opt-in
network-based location service and implement it via GNSS / A-GPS only. In the <a href="/features#network-location">network location</a> feature.</p>
future, we plan on providing a pseudo-network geolocation service for the OS
by using a local database of cell towers, and the location redirection feature
can also make use of this future OS implementation for network location
requests once it's available.</p>
<p>The Google Location Accuracy and Google settings activities would normally <p>The Google Location Accuracy and Google settings activities would normally
be integrated into the OS but we don't include any of the standard Google Play be integrated into the OS but we don't include any of the standard Google Play