diff --git a/doc/articles/features/windows-devices-geolocation.md b/doc/articles/features/windows-devices-geolocation.md index a60b7457c8ae..033a768c0fe3 100644 --- a/doc/articles/features/windows-devices-geolocation.md +++ b/doc/articles/features/windows-devices-geolocation.md @@ -23,6 +23,18 @@ The following `Geolocator` APIs are implemented on Android, iOS, macOS, and WASM * `DesiredAccuracy` * `DesiredAccuracyInMeters` +### Platform-specific Requirements + +#### Android + +When using the `RequestAccessAsync` method on Android, you must configure one permission before using this API in your project. To do so, add the following to your `AndroidManifest.xml` file: + +```xml + +``` + +Additionally, when checking for this permission, ensure that `IsLocationEnabled` returns `true`; otherwise, the method will return `GeolocationAccessStatus.Denied`. + ### Implementation notes `StatusChanged` event is delivered to all `Geolocator` instances which have subscribers as a "broadcast". This is unusual, but in line with the UWP implementation.