platform-guideline checked

Mapbox GL JS: GeolocateControl

Documents a geolocation control that uses the browser geolocation API to locate the user on the map.

Open source

Pattern Decisions This Source Supports

Pattern Supported decision Required contract Claim note
Location permission flow Choose location permission flow when current device coordinates are the central interaction and the task needs permission timing, precision, grant or denial recovery, and location lifecycle states. The native browser or OS prompt appears only after users understand why location is needed and choose a location-dependent action. Supports map-adjacent current-location controls, tracking, and disabled location states.
Map view Choose Map view when spatial relationship, proximity, coverage, route, region, or real-world placement changes the user's decision. Markers, shapes, routes, clusters, and overlays represent explicit coordinates, features, or geographic areas, not decorative positions. Mapbox documents a geolocation control based on the browser geolocation API.

Evidence Role

This source is treated as platform-guideline evidence. Use it to validate the decision rules above, not as a visual style reference.

Publisher: Mapbox. Last checked: .