Play KML tour

Play tours in KML files.

Use case

KML, the file format used by Google Earth, supports creating tours, which can control the viewpoint of the scene, hide and show content, and play audio. Tours allow you to easily share tours of geographic locations, which can be augmented with rich multimedia. The Maps SDKs allow you to consume these tours using a simple API.

How to use the sample

The sample will load the KMZ file from ArcGIS Online. When a tour is found, the play button will be enabled. Use the play and pause button to control the tour. When you’re ready to show the tour, use the reset button to return the tour to the unplayed state.

How it works

1. Load the KMLDataset and add it to a layer.
2. Create the KML tour controller. Wire up the buttons to the play(), pause(), and reset() methods.
3. Explore the tree of KML content and find a KML tour. Once a tour is found, provide it to the KML tour controller.
4. Enable the buttons to allow the user to play, pause, and reset the tour.

Relevant API

• KMLTour
• KMLTour.Status
• KMLTourController
• KMLTourController.pause()
• KMLTourController.play()
• KMLTourController.reset()
• KMLTourController.tour

Offline data

Data will be downloaded by the sample viewer automatically.

• Esri_tour.kmz

About the data

This sample uses a custom tour created by a member of the ArcGIS Map SDK samples team. When you play the tour, you’ll see a narrated journey through some of Esri’s offices.

Additional information

See Touring in KML in Keyhole Markup Language for more information.

Tags

animation, interactive, KML, narration, pause, play, story, tour