App integration

ArcGIS Earth can be opened from a hyperlink or integrated with other apps with the ArcGIS Earth link, which begins with https://earth.arcgis.app. The link works for Windows, Android, and iOS apps, and the optional URL parameters described in the following table can be added to customize how the app opens.

It is recommended that you encode the URL parameter so it will always work properly in different environments and systems. One way to create encoded parameters is to use ArcGIS Arcade. The UrlEncode function allows you to define a collection of key value pairs that represent each parameter and produce a URL with appropriate encoding.

Parameter	Description	Example
viewpoint	The viewpoint parameter defines the location on the scene that is viewed when opening the app in the following ways: Camera—Defines the camera position as viewpoint=cam:x,y,z,wkid;h,t, where x, y, z are the required longitude, latitude, and elevation, and wkid, h, t are the optional spatial reference system, heading, and tilt. Extent—Defines the view extent as viewpoint=ext:xmin,ymin,xmax,ymax,wkid, where xmin, ymin, xmax, ymax are the boundary of the extent, and wkid is the optional spatial reference system. Center—Defines the center location as viewpoint=center:x,y,scale,wkid, where x, y are the longitude and latitude, scale is the ratio of the distance in real world compared to that on the scene in the app, and wkid is the optional spatial reference system.	Camera: viewpoint=cam:10.1338,46.3837,3468.5521;10.1,65.85 or encoded: viewpoint=cam%3A10.1338%2C46.3837%2C3468.5521%3B10.1%2C65.85 Extent: viewpoint=ext:47.7788,15.1519,49.9426,14.1399 Or encoded: viewpoint= ext%3A47.7788%2C15.1519%2C49.9426%2C14.1399 Center: viewpoint=center:-169.1601,64.7674,5000000 or encoded: viewpoint=center%3A-169.1601%2C64.7674%2C5000000
url	The url parameter represents online services, portal items, or web services that are supported in ArcGIS Earth when you add data from a URL.	url=https://www.arcgis.com/home/item.html?id=19dcff93eeb64f208d09d328656dd492 Or encoded: url=https%3A%2F%2Fwww.arcgis.com%2Fhome%2Fitem.html%3Fid%3D19dcff93eeb64f208d09d328656dd492
urls	The urls parameter represents one or more online services or portal items that are supported in ArcGIS Earth when you add data from a URL.	urls=https://www.arcgis.com/home/item.html?id= d957997ccee7408287a963600a77f61f,https://services9.arcgis.com/RHVPKKiFTONKtxq3/arcgis/rest/services/Satellite_VIIRS_Thermal_Hotspots_and_Fire_Activity/FeatureServer Or encoded: urls=https%3A%2F%2Fwww.arcgis.com%2Fhome%2Fitem.html%3Fid%3Dd957997ccee7408287a963600a77f61f,https%3A%2F%2Fservices9.arcgis.com%2FRHVPKKiFTONKtxq3%2Farcgis%2Frest%2Fservices%2FSatellite_VIIRS_Thermal_Hotspots_and_Fire_Activity%2FFeatureServer
basemapUrl	The basemapUrl parameter sets a basemap from an ArcGIS Online basemap item.	basemapUrl=https://www.arcgis.com/home/item.html?id=a69f14ea2e784e019f4a4b6835ffd376 Or encoded: basemapUrl=https%3A%2F%2Fwww.arcgis.com%2Fhome%2Fitem.html%3Fid%3Da69f14ea2e784e019f4a4b6835ffd376