Learn how to display the current device location on a mapA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers. Learn more or sceneA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data. Learn more .

Map with a blue device location marker and a location search field at the top.

You can display the device location on a map or scene. This is important for workflows that require the user’s current location, such as finding nearby businesses, navigating from the current location, or identifying and collecting geospatial information.

By default, location display uses the device’s location provider. Your app can also process input from other location providers, such as an external GPS receiver or a provider that returns a simulated location. For more information, see the Show device location topic.

Prerequisites

Before starting this tutorial:

  1. You need an ArcGIS Location Platform or ArcGIS Online account.

  2. Confirm that your system meets the minimum system requirements.

  3. An IDE for Java.

Steps

Open a Java project with Gradle

  1. To start this tutorial, complete the Display a map tutorial, or download and unzip the Display a map solution into a new folder.

  2. Open the build.gradle file as a project in IntelliJ IDEA.

  3. If you downloaded the solution, get an access token and set the API key.

Prepare files before coding the app

Modify the files from the Display a map tutorial so they can be used in this tutorial: you will add imports, change the application title, and remove unnecessary code; you will then add a requirement to the Java module definition and a dependency to the build configuration.

  1. In IntelliJ IDEA’s Project tool window, open src/main/java/com.example.app and double-click App. Add the following imports, replacing those from the Display a map tutorial

    App.java
    package com.example.app;
    import java.nio.charset.StandardCharsets;
    import java.util.Calendar;
    import javafx.application.Application;
    import javafx.scene.Scene;
    import javafx.scene.control.Alert;
    import javafx.scene.layout.StackPane;
    import javafx.stage.Stage;
    import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
    import com.esri.arcgisruntime.geometry.Geometry;
    import com.esri.arcgisruntime.geometry.Polyline;
    import com.esri.arcgisruntime.geometry.SpatialReferences;
    import com.esri.arcgisruntime.loadable.LoadStatus;
    import com.esri.arcgisruntime.location.SimulatedLocationDataSource;
    import com.esri.arcgisruntime.location.SimulationParameters;
    import com.esri.arcgisruntime.mapping.ArcGISMap;
    import com.esri.arcgisruntime.mapping.BasemapStyle;
    import com.esri.arcgisruntime.mapping.view.LocationDisplay;
    import com.esri.arcgisruntime.mapping.view.MapView;
    import org.apache.commons.io.IOUtils;
    public class App extends Application {
    • In the start() life-cycle method, change the title that will appear on the application window to Display device location.

      App.java
      @Override
      public void start(Stage stage) {
      try {
      // set the title and size of the stage and show it
      stage.setTitle("Display device location");
      stage.setWidth(800);
      stage.setHeight(700);
      stage.show();
      • Delete the map’s initial viewpointA viewpoint is a set of parameters used to define a geographic area visible in a map or scene. Learn more . The map will zoom to the extentAn extent is a bounding rectangle with points that delineate an area for a map or scene. Learn more of the current location, so this code is no longer needed.

        App.java
        // create a map view to display the map and add it to the stack pane
        mapView = new MapView();
        stackPane.getChildren().add(mapView);
        ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_TOPOGRAPHIC);
        // set the map on the map view
        mapView.setMap(map);
        mapView.setViewpoint(new Viewpoint(34.02700, -118.80543, 144447.638572));
        • In IntelliJ IDEA’s Project tool window, double-click module-info.java. Add one requires module directive.

          module-info.java
          13 collapsed lines
          /*
          COPYRIGHT 1995-2022 ESRI
          TRADE SECRETS: ESRI PROPRIETARY AND CONFIDENTIAL
          Unpublished material - all rights reserved under the
          Copyright Laws of the United States.
          For additional information, contact:
          Environmental Systems Research Institute, Inc.
          Attn: Contracts Dept
          380 New York Street
          Redlands, California, USA 92373
          email: contracts@esri.com
          */
          module com.example.app {
          // require ArcGIS Runtime module
          requires com.esri.arcgisruntime;
          // requires JavaFX modules that the application uses
          requires javafx.graphics;
          // requires SLF4j module
          requires org.slf4j.nop;
          requires org.apache.commons.io;
          exports com.example.app;
          }
          • In IntelliJ IDEA’s Project tool window, double-click build.gradle. Add one dependency and load the gradle changes.

            build.gradle
            27 collapsed lines
            plugins {
            id 'application'
            id 'org.openjfx.javafxplugin' version '0.1.0'
            id 'idea'
            }
            idea {
            module {
            downloadJavadoc = true
            }
            }
            ext {
            arcgisVersion = '200.6.0'
            }
            repositories {
            mavenCentral()
            maven {
            url 'https://esri.jfrog.io/artifactory/arcgis'
            }
            }
            configurations {
            natives
            }
            dependencies {
            implementation 'commons-io:commons-io:2.17.0'
            implementation "com.esri.arcgisruntime:arcgis-java:$arcgisVersion"
            natives "com.esri.arcgisruntime:arcgis-java-jnilibs:$arcgisVersion"
            natives "com.esri.arcgisruntime:arcgis-java-resources:$arcgisVersion"
            implementation "org.slf4j:slf4j-nop:2.0.16"
            }
            29 collapsed lines
            javafx {
            version = "21.0.5"
            modules = [ 'javafx.controls', 'javafx.graphics', 'javafx.fxml', 'javafx.web', 'javafx.media' ]
            }
            application {
            mainModule = "com.example.app"
            mainClass = "com.example.app.App"
            }
            task copyNatives(type: Copy) {
            description = "Copies the arcgis native libraries into the .arcgis directory for development."
            group = "build"
            configurations.natives.asFileTree.each {
            from(zipTree(it))
            }
            into "${System.properties.getProperty("user.home")}/.arcgis/$arcgisVersion"
            }
            run {
            dependsOn copyNatives
            }
            wrapper {
            gradleVersion = '8.10.2'
            }

            Create simulated location data

            Simulation of location data allows this app to run on devices that do not have location services or do not have an actively updating GPS signal. Simulated data is also useful for testing your own location-enabled apps. For more information, see Simulated device location updates.

            For this tutorial, you will use simulated location data: a set of location points defined in json. The location points are from a walk around a large parking lot. To display a user’s real position, you would use NmeaLocationDataSource instead.

            1. On your file system, create a file named polyline_data.json in the src/main/resources/ directory of your project. Then paste the following json code into it.

              polyline_data.json
              {
              "paths": [
              [
              [-117.19810659418077, 34.057405229888325],
              [-117.19814377275544, 34.057211176001729],
              [-117.19775710911107, 34.057177293200773],
              [-117.1973868388223, 34.057255151357538],
              [-117.19724927620958, 34.057458446284997],
              [-117.1973853161779, 34.057553079922293],
              [-117.19752637683034, 34.057534135490592],
              [-117.19771293355865, 34.057471254533809],
              [-117.19794672280628, 34.057485315324428],
              [-117.19810659418077, 34.057405229888325]
              ]
              ],
              "spatialReference": {
              "wkid": 102100,
              "latestWkid": 3857
              }
              }
              • From those location points, create a Polyline that traces the route through the parking lot.

                In App.java, get the data from the json file, using IOUtils.string(), which you imported from the commons-io dependency in the previous section. Then call Geometry.fromJson() and cast the returned Geometry to a Polyline.

                App.java
                77 collapsed lines
                /*
                * Copyright 2020 Esri.
                *
                * Licensed under the Apache License, Version 2.0 (the "License"); you may not
                * use this file except in compliance with the License. You may obtain a copy of
                * the License at
                *
                * http://www.apache.org/licenses/LICENSE-2.0
                *
                * Unless required by applicable law or agreed to in writing, software
                * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
                * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
                * License for the specific language governing permissions and limitations under
                * the License.
                */
                package com.example.app;
                import java.nio.charset.StandardCharsets;
                import java.util.Calendar;
                import javafx.application.Application;
                import javafx.scene.Scene;
                import javafx.scene.control.Alert;
                import javafx.scene.layout.StackPane;
                import javafx.stage.Stage;
                import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
                import com.esri.arcgisruntime.geometry.Geometry;
                import com.esri.arcgisruntime.geometry.Polyline;
                import com.esri.arcgisruntime.geometry.SpatialReferences;
                import com.esri.arcgisruntime.loadable.LoadStatus;
                import com.esri.arcgisruntime.location.SimulatedLocationDataSource;
                import com.esri.arcgisruntime.location.SimulationParameters;
                import com.esri.arcgisruntime.mapping.ArcGISMap;
                import com.esri.arcgisruntime.mapping.BasemapStyle;
                import com.esri.arcgisruntime.mapping.view.LocationDisplay;
                import com.esri.arcgisruntime.mapping.view.MapView;
                import org.apache.commons.io.IOUtils;
                public class App extends Application {
                private MapView mapView;
                public static void main(String[] args) {
                Application.launch(args);
                }
                @Override
                public void start(Stage stage) {
                // set the title and size of the stage and show it
                stage.setTitle("Display device location");
                stage.setWidth(800);
                stage.setHeight(700);
                stage.show();
                // create a JavaFX scene with a stack pane as the root node, and add it to the scene
                StackPane stackPane = new StackPane();
                Scene scene = new Scene(stackPane);
                stage.setScene(scene);
                ArcGISRuntimeEnvironment.setApiKey("YOUR_ACCESS_TOKEN");
                // create a map view to display the map and add it to the stack pane
                mapView = new MapView();
                stackPane.getChildren().add(mapView);
                ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_TOPOGRAPHIC);
                // set the map on the map view
                mapView.setMap(map);
                // access the json of the location points
                String polylineData = IOUtils.toString(getClass().getResourceAsStream(
                "/polyline_data.json"), StandardCharsets.UTF_8);
                // create a polyline from the location points
                Polyline locations = (Polyline) Geometry.fromJson(polylineData, SpatialReferences.getWgs84());
                14 collapsed lines
                }
                /**
                * Stops and releases all resources used in application.
                */
                @Override
                public void stop() {
                if (mapView != null) {
                mapView.dispose();
                }
                }
                }
                • Create a SimulatedLocationDataSource and set the location data points on it, and then pass the polyline describing the route and the SimulationParameters to SimulateLocationDataSource.setLocations().

                  App.java
                  77 collapsed lines
                  /*
                  * Copyright 2020 Esri.
                  *
                  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
                  * use this file except in compliance with the License. You may obtain a copy of
                  * the License at
                  *
                  * http://www.apache.org/licenses/LICENSE-2.0
                  *
                  * Unless required by applicable law or agreed to in writing, software
                  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
                  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
                  * License for the specific language governing permissions and limitations under
                  * the License.
                  */
                  package com.example.app;
                  import java.nio.charset.StandardCharsets;
                  import java.util.Calendar;
                  import javafx.application.Application;
                  import javafx.scene.Scene;
                  import javafx.scene.control.Alert;
                  import javafx.scene.layout.StackPane;
                  import javafx.stage.Stage;
                  import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
                  import com.esri.arcgisruntime.geometry.Geometry;
                  import com.esri.arcgisruntime.geometry.Polyline;
                  import com.esri.arcgisruntime.geometry.SpatialReferences;
                  import com.esri.arcgisruntime.loadable.LoadStatus;
                  import com.esri.arcgisruntime.location.SimulatedLocationDataSource;
                  import com.esri.arcgisruntime.location.SimulationParameters;
                  import com.esri.arcgisruntime.mapping.ArcGISMap;
                  import com.esri.arcgisruntime.mapping.BasemapStyle;
                  import com.esri.arcgisruntime.mapping.view.LocationDisplay;
                  import com.esri.arcgisruntime.mapping.view.MapView;
                  import org.apache.commons.io.IOUtils;
                  public class App extends Application {
                  private MapView mapView;
                  public static void main(String[] args) {
                  Application.launch(args);
                  }
                  @Override
                  public void start(Stage stage) {
                  // set the title and size of the stage and show it
                  stage.setTitle("Display device location");
                  stage.setWidth(800);
                  stage.setHeight(700);
                  stage.show();
                  // create a JavaFX scene with a stack pane as the root node, and add it to the scene
                  StackPane stackPane = new StackPane();
                  Scene scene = new Scene(stackPane);
                  stage.setScene(scene);
                  ArcGISRuntimeEnvironment.setApiKey("YOUR_ACCESS_TOKEN");
                  // create a map view to display the map and add it to the stack pane
                  mapView = new MapView();
                  stackPane.getChildren().add(mapView);
                  ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_TOPOGRAPHIC);
                  // set the map on the map view
                  mapView.setMap(map);
                  // access the json of the location points
                  String polylineData = IOUtils.toString(getClass().getResourceAsStream(
                  "/polyline_data.json"), StandardCharsets.UTF_8);
                  // create a polyline from the location points
                  Polyline locations = (Polyline) Geometry.fromJson(polylineData, SpatialReferences.getWgs84());
                  // create a simulated location data source
                  SimulatedLocationDataSource simulatedLocationDataSource = new SimulatedLocationDataSource();
                  // set the location of the simulated location data source with simulation parameters to set a consistent velocity
                  simulatedLocationDataSource.setLocations(
                  locations, new SimulationParameters(Calendar.getInstance(), 5.0, 0.0, 0.0));
                  14 collapsed lines
                  }
                  /**
                  * Stops and releases all resources used in application.
                  */
                  @Override
                  public void stop() {
                  if (mapView != null) {
                  mapView.dispose();
                  }
                  }
                  }

                  Show the current location

                  Each map view has its own instance of a LocationDisplay that shows the current location (point) of the deviceA device is nearly any kind of computer, including desktops, laptops, mobile phones, and tablets. Learn more . This is displayed as an overlay in the map viewA map view is a user interface that displays map layers and graphics in 2D. It controls the area (extent) of the map that is visible and supports user interactions such as pan and zoom. Learn more .

                  1. In start(), get the location display and set the simulated location data source on it.

                    App.java
                    77 collapsed lines
                    /*
                    * Copyright 2020 Esri.
                    *
                    * Licensed under the Apache License, Version 2.0 (the "License"); you may not
                    * use this file except in compliance with the License. You may obtain a copy of
                    * the License at
                    *
                    * http://www.apache.org/licenses/LICENSE-2.0
                    *
                    * Unless required by applicable law or agreed to in writing, software
                    * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
                    * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
                    * License for the specific language governing permissions and limitations under
                    * the License.
                    */
                    package com.example.app;
                    import java.nio.charset.StandardCharsets;
                    import java.util.Calendar;
                    import javafx.application.Application;
                    import javafx.scene.Scene;
                    import javafx.scene.control.Alert;
                    import javafx.scene.layout.StackPane;
                    import javafx.stage.Stage;
                    import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
                    import com.esri.arcgisruntime.geometry.Geometry;
                    import com.esri.arcgisruntime.geometry.Polyline;
                    import com.esri.arcgisruntime.geometry.SpatialReferences;
                    import com.esri.arcgisruntime.loadable.LoadStatus;
                    import com.esri.arcgisruntime.location.SimulatedLocationDataSource;
                    import com.esri.arcgisruntime.location.SimulationParameters;
                    import com.esri.arcgisruntime.mapping.ArcGISMap;
                    import com.esri.arcgisruntime.mapping.BasemapStyle;
                    import com.esri.arcgisruntime.mapping.view.LocationDisplay;
                    import com.esri.arcgisruntime.mapping.view.MapView;
                    import org.apache.commons.io.IOUtils;
                    public class App extends Application {
                    private MapView mapView;
                    public static void main(String[] args) {
                    Application.launch(args);
                    }
                    @Override
                    public void start(Stage stage) {
                    // set the title and size of the stage and show it
                    stage.setTitle("Display device location");
                    stage.setWidth(800);
                    stage.setHeight(700);
                    stage.show();
                    // create a JavaFX scene with a stack pane as the root node, and add it to the scene
                    StackPane stackPane = new StackPane();
                    Scene scene = new Scene(stackPane);
                    stage.setScene(scene);
                    ArcGISRuntimeEnvironment.setApiKey("YOUR_ACCESS_TOKEN");
                    // create a map view to display the map and add it to the stack pane
                    mapView = new MapView();
                    stackPane.getChildren().add(mapView);
                    ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_TOPOGRAPHIC);
                    // set the map on the map view
                    mapView.setMap(map);
                    // access the json of the location points
                    String polylineData = IOUtils.toString(getClass().getResourceAsStream(
                    "/polyline_data.json"), StandardCharsets.UTF_8);
                    // create a polyline from the location points
                    Polyline locations = (Polyline) Geometry.fromJson(polylineData, SpatialReferences.getWgs84());
                    // create a simulated location data source
                    SimulatedLocationDataSource simulatedLocationDataSource = new SimulatedLocationDataSource();
                    // set the location of the simulated location data source with simulation parameters to set a consistent velocity
                    simulatedLocationDataSource.setLocations(
                    locations, new SimulationParameters(Calendar.getInstance(), 5.0, 0.0, 0.0));
                    // configure the map view's location display to follow the simulated location data source
                    LocationDisplay locationDisplay = mapView.getLocationDisplay();
                    locationDisplay.setLocationDataSource(simulatedLocationDataSource);
                    14 collapsed lines
                    }
                    /**
                    * Stops and releases all resources used in application.
                    */
                    @Override
                    public void stop() {
                    if (mapView != null) {
                    mapView.dispose();
                    }
                    }
                    }
                    • Set the autopan mode to recenter. (For other autopan modes, see the LocationDisplay.AutoPanMode enum.) Then set the initial zoom scale to 1000, using LocationDisplay.setInitialZoomScale().

                      App.java
                      77 collapsed lines
                      /*
                      * Copyright 2020 Esri.
                      *
                      * Licensed under the Apache License, Version 2.0 (the "License"); you may not
                      * use this file except in compliance with the License. You may obtain a copy of
                      * the License at
                      *
                      * http://www.apache.org/licenses/LICENSE-2.0
                      *
                      * Unless required by applicable law or agreed to in writing, software
                      * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
                      * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
                      * License for the specific language governing permissions and limitations under
                      * the License.
                      */
                      package com.example.app;
                      import java.nio.charset.StandardCharsets;
                      import java.util.Calendar;
                      import javafx.application.Application;
                      import javafx.scene.Scene;
                      import javafx.scene.control.Alert;
                      import javafx.scene.layout.StackPane;
                      import javafx.stage.Stage;
                      import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
                      import com.esri.arcgisruntime.geometry.Geometry;
                      import com.esri.arcgisruntime.geometry.Polyline;
                      import com.esri.arcgisruntime.geometry.SpatialReferences;
                      import com.esri.arcgisruntime.loadable.LoadStatus;
                      import com.esri.arcgisruntime.location.SimulatedLocationDataSource;
                      import com.esri.arcgisruntime.location.SimulationParameters;
                      import com.esri.arcgisruntime.mapping.ArcGISMap;
                      import com.esri.arcgisruntime.mapping.BasemapStyle;
                      import com.esri.arcgisruntime.mapping.view.LocationDisplay;
                      import com.esri.arcgisruntime.mapping.view.MapView;
                      import org.apache.commons.io.IOUtils;
                      public class App extends Application {
                      private MapView mapView;
                      public static void main(String[] args) {
                      Application.launch(args);
                      }
                      @Override
                      public void start(Stage stage) {
                      // set the title and size of the stage and show it
                      stage.setTitle("Display device location");
                      stage.setWidth(800);
                      stage.setHeight(700);
                      stage.show();
                      // create a JavaFX scene with a stack pane as the root node, and add it to the scene
                      StackPane stackPane = new StackPane();
                      Scene scene = new Scene(stackPane);
                      stage.setScene(scene);
                      ArcGISRuntimeEnvironment.setApiKey("YOUR_ACCESS_TOKEN");
                      // create a map view to display the map and add it to the stack pane
                      mapView = new MapView();
                      stackPane.getChildren().add(mapView);
                      ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_TOPOGRAPHIC);
                      // set the map on the map view
                      mapView.setMap(map);
                      // access the json of the location points
                      String polylineData = IOUtils.toString(getClass().getResourceAsStream(
                      "/polyline_data.json"), StandardCharsets.UTF_8);
                      // create a polyline from the location points
                      Polyline locations = (Polyline) Geometry.fromJson(polylineData, SpatialReferences.getWgs84());
                      // create a simulated location data source
                      SimulatedLocationDataSource simulatedLocationDataSource = new SimulatedLocationDataSource();
                      // set the location of the simulated location data source with simulation parameters to set a consistent velocity
                      simulatedLocationDataSource.setLocations(
                      locations, new SimulationParameters(Calendar.getInstance(), 5.0, 0.0, 0.0));
                      // configure the map view's location display to follow the simulated location data source
                      LocationDisplay locationDisplay = mapView.getLocationDisplay();
                      locationDisplay.setLocationDataSource(simulatedLocationDataSource);
                      locationDisplay.setAutoPanMode(LocationDisplay.AutoPanMode.RECENTER);
                      locationDisplay.setInitialZoomScale(1000);
                      14 collapsed lines
                      }
                      /**
                      * Stops and releases all resources used in application.
                      */
                      @Override
                      public void stop() {
                      if (mapView != null) {
                      mapView.dispose();
                      }
                      }
                      }
                      • Once the map has loaded, start the location display.

                        App.java
                        77 collapsed lines
                        /*
                        * Copyright 2020 Esri.
                        *
                        * Licensed under the Apache License, Version 2.0 (the "License"); you may not
                        * use this file except in compliance with the License. You may obtain a copy of
                        * the License at
                        *
                        * http://www.apache.org/licenses/LICENSE-2.0
                        *
                        * Unless required by applicable law or agreed to in writing, software
                        * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
                        * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
                        * License for the specific language governing permissions and limitations under
                        * the License.
                        */
                        package com.example.app;
                        import java.nio.charset.StandardCharsets;
                        import java.util.Calendar;
                        import javafx.application.Application;
                        import javafx.scene.Scene;
                        import javafx.scene.control.Alert;
                        import javafx.scene.layout.StackPane;
                        import javafx.stage.Stage;
                        import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
                        import com.esri.arcgisruntime.geometry.Geometry;
                        import com.esri.arcgisruntime.geometry.Polyline;
                        import com.esri.arcgisruntime.geometry.SpatialReferences;
                        import com.esri.arcgisruntime.loadable.LoadStatus;
                        import com.esri.arcgisruntime.location.SimulatedLocationDataSource;
                        import com.esri.arcgisruntime.location.SimulationParameters;
                        import com.esri.arcgisruntime.mapping.ArcGISMap;
                        import com.esri.arcgisruntime.mapping.BasemapStyle;
                        import com.esri.arcgisruntime.mapping.view.LocationDisplay;
                        import com.esri.arcgisruntime.mapping.view.MapView;
                        import org.apache.commons.io.IOUtils;
                        public class App extends Application {
                        private MapView mapView;
                        public static void main(String[] args) {
                        Application.launch(args);
                        }
                        @Override
                        public void start(Stage stage) {
                        // set the title and size of the stage and show it
                        stage.setTitle("Display device location");
                        stage.setWidth(800);
                        stage.setHeight(700);
                        stage.show();
                        // create a JavaFX scene with a stack pane as the root node, and add it to the scene
                        StackPane stackPane = new StackPane();
                        Scene scene = new Scene(stackPane);
                        stage.setScene(scene);
                        ArcGISRuntimeEnvironment.setApiKey("YOUR_ACCESS_TOKEN");
                        // create a map view to display the map and add it to the stack pane
                        mapView = new MapView();
                        stackPane.getChildren().add(mapView);
                        ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_TOPOGRAPHIC);
                        // set the map on the map view
                        mapView.setMap(map);
                        // access the json of the location points
                        String polylineData = IOUtils.toString(getClass().getResourceAsStream(
                        "/polyline_data.json"), StandardCharsets.UTF_8);
                        // create a polyline from the location points
                        Polyline locations = (Polyline) Geometry.fromJson(polylineData, SpatialReferences.getWgs84());
                        // create a simulated location data source
                        SimulatedLocationDataSource simulatedLocationDataSource = new SimulatedLocationDataSource();
                        // set the location of the simulated location data source with simulation parameters to set a consistent velocity
                        simulatedLocationDataSource.setLocations(
                        locations, new SimulationParameters(Calendar.getInstance(), 5.0, 0.0, 0.0));
                        // configure the map view's location display to follow the simulated location data source
                        LocationDisplay locationDisplay = mapView.getLocationDisplay();
                        locationDisplay.setLocationDataSource(simulatedLocationDataSource);
                        locationDisplay.setAutoPanMode(LocationDisplay.AutoPanMode.RECENTER);
                        locationDisplay.setInitialZoomScale(1000);
                        map.addDoneLoadingListener(() -> {
                        if (map.getLoadStatus() == LoadStatus.LOADED) {
                        // start the location display
                        locationDisplay.startAsync();
                        } else {
                        new Alert(Alert.AlertType.ERROR, "Map failed to load: " + map.getLoadError().getCause().getMessage()).show();
                        }
                        });
                        15 collapsed lines
                        }
                        /**
                        * Stops and releases all resources used in application.
                        */
                        @Override
                        public void stop() {
                        if (mapView != null) {
                        mapView.dispose();
                        }
                        }
                        }
                        • Wrap your code in start() with try and catch blocks.

                          App.java
                          50 collapsed lines
                          /*
                          * Copyright 2020 Esri.
                          *
                          * Licensed under the Apache License, Version 2.0 (the "License"); you may not
                          * use this file except in compliance with the License. You may obtain a copy of
                          * the License at
                          *
                          * http://www.apache.org/licenses/LICENSE-2.0
                          *
                          * Unless required by applicable law or agreed to in writing, software
                          * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
                          * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
                          * License for the specific language governing permissions and limitations under
                          * the License.
                          */
                          package com.example.app;
                          import java.nio.charset.StandardCharsets;
                          import java.util.Calendar;
                          import javafx.application.Application;
                          import javafx.scene.Scene;
                          import javafx.scene.control.Alert;
                          import javafx.scene.layout.StackPane;
                          import javafx.stage.Stage;
                          import com.esri.arcgisruntime.ArcGISRuntimeEnvironment;
                          import com.esri.arcgisruntime.geometry.Geometry;
                          import com.esri.arcgisruntime.geometry.Polyline;
                          import com.esri.arcgisruntime.geometry.SpatialReferences;
                          import com.esri.arcgisruntime.loadable.LoadStatus;
                          import com.esri.arcgisruntime.location.SimulatedLocationDataSource;
                          import com.esri.arcgisruntime.location.SimulationParameters;
                          import com.esri.arcgisruntime.mapping.ArcGISMap;
                          import com.esri.arcgisruntime.mapping.BasemapStyle;
                          import com.esri.arcgisruntime.mapping.view.LocationDisplay;
                          import com.esri.arcgisruntime.mapping.view.MapView;
                          import org.apache.commons.io.IOUtils;
                          public class App extends Application {
                          private MapView mapView;
                          public static void main(String[] args) {
                          Application.launch(args);
                          }
                          @Override
                          public void start(Stage stage) {
                          try {
                          // set the title and size of the stage and show it
                          stage.setTitle("Display device location");
                          stage.setWidth(800);
                          stage.setHeight(700);
                          stage.show();
                          68 collapsed lines
                          // create a JavaFX scene with a stack pane as the root node, and add it to the scene
                          StackPane stackPane = new StackPane();
                          Scene scene = new Scene(stackPane);
                          stage.setScene(scene);
                          ArcGISRuntimeEnvironment.setApiKey("YOUR_ACCESS_TOKEN");
                          // create a map view to display the map and add it to the stack pane
                          mapView = new MapView();
                          stackPane.getChildren().add(mapView);
                          ArcGISMap map = new ArcGISMap(BasemapStyle.ARCGIS_TOPOGRAPHIC);
                          // set the map on the map view
                          mapView.setMap(map);
                          // access the json of the location points
                          String polylineData = IOUtils.toString(getClass().getResourceAsStream(
                          "/polyline_data.json"), StandardCharsets.UTF_8);
                          // create a polyline from the location points
                          Polyline locations = (Polyline) Geometry.fromJson(polylineData, SpatialReferences.getWgs84());
                          // create a simulated location data source
                          SimulatedLocationDataSource simulatedLocationDataSource = new SimulatedLocationDataSource();
                          // set the location of the simulated location data source with simulation parameters to set a consistent velocity
                          simulatedLocationDataSource.setLocations(
                          locations, new SimulationParameters(Calendar.getInstance(), 5.0, 0.0, 0.0));
                          // configure the map view's location display to follow the simulated location data source
                          LocationDisplay locationDisplay = mapView.getLocationDisplay();
                          locationDisplay.setLocationDataSource(simulatedLocationDataSource);
                          locationDisplay.setAutoPanMode(LocationDisplay.AutoPanMode.RECENTER);
                          locationDisplay.setInitialZoomScale(1000);
                          map.addDoneLoadingListener(() -> {
                          if (map.getLoadStatus() == LoadStatus.LOADED) {
                          // start the location display
                          locationDisplay.startAsync();
                          } else {
                          new Alert(Alert.AlertType.ERROR, "Map failed to load: " + map.getLoadError().getCause().getMessage()).show();
                          }
                          });
                          } catch (Exception e) {
                          // on any error, display the stack trace.
                          e.printStackTrace();
                          }
                          }
                          /**
                          * Stops and releases all resources used in application.
                          */
                          @Override
                          public void stop() {
                          if (mapView != null) {
                          mapView.dispose();
                          }
                          }
                          }
                          • Run the app. Ensure to run the app as a Gradle task and not as an application in your IDE. In the Gradle tool window, under Tasks > application, double-click run.

                          You will see the initial location displayed as a round blue symbol on the map. The location symbol then changes into a white arrowhead within a blue circle and begins walking around the parking lot as the location display consumes the simulated data. When the end of the data is reached, the route repeats.

                          Different location symbols are used in different autopan modes, and a location symbol’s appearance changes whenever a location is acquired. See LocationDisplay.AutoPanMode for details.

                          What’s next?

                          Learn how to use additional API features, ArcGIS location services, and ArcGIS tools in these tutorials: