Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Improved readme #147

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Improved readme #147

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
0cba622
Improved readme
ale5000-git Jan 6, 2018
5e2a8c6
Fixed error in the text
ale5000-git Jan 6, 2018
414673b
Minor change in the text
ale5000-git Jan 8, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 43 additions & 16 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,31 +20,57 @@ Keep in mind that:
* There is another repo containing the [deprecated version](https://github.com/microg/NetworkLocation) of NetworkLocation.apk without the plug-in system.
* [microG GmsCore](https://github.com/microg/android_packages_apps_GmsCore/wiki) project already includes the Unified Network Location Provider.


### Android 4.4 - 7.1.1 (KitKat / Lollipop / Marshmallow / Nougat)
Most modern ROMs come with support for non-Google geolocation providers. On these systems installation is easy:
Most modern ROMs come with support for non-Google geolocation providers.
On these systems installation is easy:

1. Make sure that no Google geolocation tool is installed (it is usually listed as Google Play Services in Apps)
2. Download and install `NetworkLocation.apk` as a usual app (you may need to enable "Unknown sources" in Settings->Security)
3. Reboot and continue at [Usage](#usage)

Some ROMs, especially those not based on AOSP might have problems using this method. However, if your system has root, you can try installing the hard way:
**Important:** Installing as system app will always works, instead installing as user app will only works out of the box on Android versions from 4.4 to 6.x.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should be "will only work out of the box" (minus the s)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed.

On Android 7 (or higher) can be used also as user app if you compile the ROM with an [additional patch](https://github.com/microg/android_packages_apps_UnifiedNlp/blob/master/patches/android_frameworks_base-N.patch).

1. Download `NetworkLocation.apk`
2. Mount `/system` read-write (from your PC, call `adb root && adb remount`)
3. Copy `NetworkLocation.apk` to `/system/priv-app` (from your PC, call `adb push NetworkLocation.apk /system/priv-app/NetworkLocation.apk`)
4. Reboot (from you PC, call `adb reboot`) and continue at [Usage](#usage)
**Note:** Android versions lower then 4.4 are no longer officially supported, however I still provide a legacy build that should be compatible with those systems.

**Note:** On Android 7 (or later) an [additional patch](https://github.com/microg/android_packages_apps_UnifiedNlp/blob/master/patches/android_frameworks_base-N.patch) is needed to make it working, or alternatively, you can install it in `/system/priv-app` as explained above.
To install as system app (you need root or a custom recovery) this method can be used:

### Android 2.3 - 4.3.1 (Gingerbread / Honeycomb / Ice Cream Sandwich / Jelly Bean)
Older Android versions are no longer officially supported. However I still provide a legacy build, that should be compatible with those systems.
It is required to have a rooted system to install on Jelly Bean and older.
1. Download `NetworkLocation.apk` (or `LegacyNetworkLocation.apk` on Android versions lower then 4.4)
2. Mount `/system` if not already mounted (needed only if the device is inside the recovery)
3. Remount `/system` as read-write (needed if it was mounted as read-only)
4. On Android versions equal or higher then 5 copy `NetworkLocation.apk` to `/system/priv-app/NetworkLocation`
On Android versions from 4.4 to 4.4.4 copy `NetworkLocation.apk` to `/system/priv-app`
On Android versions lower then 4.4 copy `LegacyNetworkLocation.apk` to `/system/app`
5. Reboot and continue at [Usage](#usage)

Here are listed the commands to install it as system app on various Android versions:

### Android 5 - 8.x (Lollipop / Marshmallow / Nougat / Oreo)
```shell
adb root
adb shell mount /system
adb remount
adb shell mkdir /system/priv-app/NetworkLocation
adb push NetworkLocation.apk /system/priv-app/NetworkLocation/NetworkLocation.apk
adb reboot
```

1. Download `LegacyNetworkLocation.apk`
2. Mount `/system` read-write (from your PC, call `adb root && adb remount`)
3. Copy `LegacyNetworkLocation.apk` to `/system/app` (from your PC, call `adb push LegacyNetworkLocation.apk /system/app/LegacyNetworkLocation.apk`)
4. Reboot (from you PC, call `adb reboot`) and continue at [Usage](#usage)
### Android 4.4 - 4.4.4 (KitKat)
```shell
adb root
adb shell mount /system
adb remount
adb push NetworkLocation.apk /system/priv-app/NetworkLocation.apk
adb reboot
```

### Android 2.3 - 4.3.1 (Gingerbread / Honeycomb / Ice Cream Sandwich / Jelly Bean)
```shell
adb root
adb shell mount /system
adb remount
adb push LegacyNetworkLocation.apk /system/app/LegacyNetworkLocation.apk
adb reboot
```


Usage
Expand All @@ -54,6 +80,7 @@ Here is a list of backends known to me.

List of backends for geolocation:
* [AppleWifiNlpBackend](https://github.com/microg/AppleWifiNlpBackend) - Uses Apple's service to resolve Wi-Fi locations. It has excellent coverage but the database is proprietary.
* [Déjà Vu](https://github.com/n76/DejaVu) - A backend that uses locally acquired WLAN/WiFi AP and mobile/cellular tower data to resolve user location.
Copy link

@DJCrashdummy DJCrashdummy Jul 27, 2024 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

FWIW: instead of the whole section, linking to https://github.com/microg/UnifiedNlp/wiki/Backends would be easier (and is more up-to-date).

* [OpenWlanMapNlpBackend](https://github.com/microg/OpenWlanMapNlpBackend) - Uses OpenWlanMap.org to resolve user location but the NLP backend did not reach release-quality, yet. Users interested in a freely licensed and downloadable database for offline use should stick with openBmap for now - *Last updated in 2015*
* [OpenBmapNlpBackend](https://github.com/wish7code/org.openbmap.unifiedNlpProvider) - Uses [openBmap](https://radiocells.org/) to resolve user location. Community-created, freely licensed database that can optionally be downloaded for offline operation. The coverage [varies from country to country](https://radiocells.org/stats/countries) (it's best in central Europe).
* [MozillaNlpBackend](https://github.com/microg/IchnaeaNlpBackend) - Uses the Mozilla Location Service to resolve user location. The coverage is OK. Only the cell tower database is free.
Expand Down