Locate button

Find and zoom to the user's current location using the Locate button widget. This widget uses the HTML5 Geolocation API to find the user's current location. Once the location is found, the view animates to that location, and the view rotates according to the direction where the tracked device is heading towards. The widget provides options that allow the developer to define the following:

  • HTML5 Geolocation Position options for finding a location such as maximumAge and timeout.
  • The ability to define a custom graphic to highlight the user's location on the map.

There are security considerations to be taken into account when working with geolocation. The Locate widget is not supported on insecure origins. To use it, switch your application to a secure origin, such as HTTPS. Note that localhost is considered "potentially secure" and can be used for easy testing in browsers that supportsWindow.isSecureContext(currently Chrome and Firefox).

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.