Skip to content

Commit 484efa1

Browse files
Steve WhiteSteve White
authored andcommitted
Merged PR 22300: Add service throttling diagnostics to geolocation namespace doc
Add service throttling diagnostics to geolocation namespace doc ---- #### AI description (iteration 1) #### PR Classification Documentation update. #### PR Summary This pull request adds a new section to the geolocation documentation that explains service throttling diagnostics for the Geolocation API. - `windows_devices_geolocation.md`: Introduced a "Service throttling and diagnostics" section detailing how Microsoft's location web service throttles requests and instructing developers to use Windows Event Logs (filtering for Event ID 320) to detect throttling. <!-- GitOpsUserAgent=GitOps.Apps.Server.pullrequestcopilot -->
1 parent 6e64584 commit 484efa1

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

windows.devices.geolocation/windows_devices_geolocation.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,13 @@ choosing accuracy settings:
5656
- Use [PositionAccuracy.High](positionaccuracy.md) only when precise location is required.
5757
- Respect user privacy preferences and handle denied permissions gracefully.
5858

59+
### Service throttling and diagnostics
60+
61+
> [!IMPORTANT]
62+
> Microsoft's location web service (Orion) may throttle Geolocation API requests according to service policy. This throttling applies to both single-shot and periodic location requests. When throttling occurs, the API continues to return normal values without indicating throttled status. To confirm whether requests are being throttled, you can check the Windows Event Logs.
63+
64+
To detect throttling, open **Event Viewer** > **Applications and Services Logs** > **Microsoft** > **Windows** > **LocationServiceProvider** > **Operational**, then filter for Event ID 320 (message format: "HTTP [status] for report type [value]"). The status code indicates the HTTP response from the Orion service, and the report type value identifies the workload (1 = location API, 2 = tile API).
65+
5966
## -examples
6067

6168
Sample applications that use classes from this namespace include the

0 commit comments

Comments
 (0)