diff --git a/static/features.html b/static/features.html index 9daa4db5..dc60a7e1 100644 --- a/static/features.html +++ b/static/features.html @@ -103,6 +103,7 @@
  • Broad carrier support without invasive carrier access
  • LTE-only mode
  • Wi-Fi privacy
    • +
  • Network location
  • Private screenshots
  • Closed device identifier leaks
  • Privacy by default
    • @@ -720,6 +721,31 @@ standard Wi-Fi privacy approach.

    +
    +

    Network location

    + +

    GrapheneOS provides the ability to use network location as an opt-in + feature.

    + +

    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.

    + +

    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.

    + +

    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.

    + +

    For details on how to use the network location feature, see the + usage section.

    +
    +

    Private screenshots

    diff --git a/static/usage.html b/static/usage.html index 45e1280a..da53f72e 100644 --- a/static/usage.html +++ b/static/usage.html @@ -85,6 +85,7 @@
  • Associated with an Access Point (AP)
    • +
  • Network location
  • LTE-only mode
  • Sandboxed Google Play @@ -967,6 +968,24 @@
    • +
    +

    Network location

    + +

    For more information on the network location feature and how it works, see the + features section.

    + +

    The setting can be found at Settings > + Location > Location services > Network location. The available options are using + Apple's network location service, or a GrapheneOS proxy to that service.

    + +

    To use this feature, you need to make sure that you either have Wi-Fi enabled, or that + Wi-Fi scanning is enabled at Settings > + Location > Location services > Wi-Fi scanning. Enabling the Wi-Fi scanning setting + will allow you to use network location even if you disable the global Wi-Fi toggle.

    +
    +

    LTE-only mode

    @@ -1027,7 +1046,9 @@ requests are rerouted to a reimplementation of the Play geolocation service provided by GrapheneOS. You can disable rerouting and use the standard Play services geolocation service instead if you want the Google network location - service and related features.

    + service and related features. This shouldn't be needed outside of testing or + obscure use cases, since GrapheneOS provides its own opt-in + Network Location feature.

    Our compatibility layer includes full support for the Play Store. Play Store services are fully available including in-app purchases, Play Asset Delivery, Play @@ -1090,30 +1111,30 @@

    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 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 - to use Google's network location service to provide location estimates without - satellite reception, you can disable the "Reroute location requests to OS APIs" - toggle and grant what it requires to provide network location. You will need to - grant "Allow all the time" Location access to Google Play services along with - the Nearby Devices permission for it to have all the access it needs. You need - to use the "Google Location Accuracy" link from the sandboxed Google Play - 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 - nearby Wi-Fi and cellular networks provided via the Location and Nearby Devices - permissions to their service to retrieve a location estimate. In order to fully - take advantage of Wi-Fi and Bluetooth scanning, you also need to enable the - scanning toggles in Settings > - Location  > Location services which - are disabled by default and control whether apps with the required permissions can - scan when Wi-Fi and Bluetooth are otherwise disabled.

    + in apps using Google Play geolocation due to our rerouting feature.

    + +

    This is not recommended unless you're testing something or have an obscure + use case since our network location + feature can be used instead, but if you want to use Google's network location + service to provide location estimates without satellite reception, you can + follow these steps:

    + +
      +
    1. Disable the "Reroute location requests to OS APIs" toggle.
      2. +
    2. Grant "Allow all the time" Location access to Google Play services along with the + Nearby Devices permission for it to have all the access it needs.
      3. +
    3. Use the "Google Location Accuracy" link from the sandboxed Google Play configuration + menu to access the Google Play services menu for opting into their network location service.
      4. +
    4. To take advantage of Wi-Fi and Bluetooth scanning, you also need to enable the scanning + toggles in Settings > + Location  > Location services + which are disabled by default and control whether apps with the required permissions + can scan when Wi-Fi and Bluetooth are otherwise disabled.
      5. +

    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 - network-based location service and implement it via GNSS / A-GPS only. In the - 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.

    + using the Google Play geolocation service unless you enable our opt-in + network location feature.

    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