{"id":68891,"date":"2023-05-16T14:08:14","date_gmt":"2023-05-16T21:08:14","guid":{"rendered":"http:\/\/www.esri.com\/arcgis-blog\/products\/product\/uncategorized\/using-url-parameters-in-web-apps\/"},"modified":"2023-05-18T18:28:04","modified_gmt":"2023-05-19T01:28:04","slug":"using-url-parameters-in-web-apps","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/using-url-parameters-in-web-apps","title":{"rendered":"Use URL parameters in ArcGIS Instant Apps"},"author":6111,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[22941,37511],"tags":[677501,279752],"industry":[],"product":[36821,36551],"class_list":["post-68891","blog","type-blog","status-publish","format-standard","hentry","category-mapping","category-sharing-collaboration","tag-instant-apps","tag-url-parameters","product-configurable-apps","product-arcgis-online"],"acf":{"short_description":"URL parameters can be used to pass along additional information or instructions to ArcGIS Instant Apps. Learn how to use them.","flexible_content":[{"acf_fc_layout":"content","content":"

ArcGIS Instant Apps<\/a> feature a streamlined experience that lets you build apps quickly and easily using express or full setup modes. All Instant Apps templates can found on the searchable Instant Apps home page.<\/p>\n

URL parameters can be used to pass along additional information or instructions to many ArcGIS Instant Apps. For example, you can zoom an app to a specific location, zoom in to a specific scale level, find a location, and more.<\/p>\n

URL parameters follow a question mark (?) and are made of a key-value pair connected with an equal sign (=). For example, Map Viewer takes the ID of the web map to open as a URL parameter.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1929302,"id":1929302,"title":"urlp-2","filename":"urlp-2.png","filesize":7362,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/05\/urlp-2.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/url-parameters-pop-ups\/urlp-2","alt":"URL parameter syntax","author":"7641","description":"","caption":"","name":"urlp-2","status":"inherit","uploaded_to":81461,"date":"2023-05-11 00:57:35","modified":"2023-05-11 00:57:47","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":762,"height":45,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/05\/urlp-2-213x45.png","thumbnail-width":213,"thumbnail-height":45,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/05\/urlp-2.png","medium-width":464,"medium-height":27,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/05\/urlp-2.png","medium_large-width":762,"medium_large-height":45,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/05\/urlp-2.png","large-width":762,"large-height":45,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/05\/urlp-2.png","1536x1536-width":762,"1536x1536-height":45,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/05\/urlp-2.png","2048x2048-width":762,"2048x2048-height":45,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/05\/urlp-2.png","card_image-width":762,"card_image-height":45,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2019\/05\/urlp-2.png","wide_image-width":762,"wide_image-height":45}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Likewise, Instant Apps (like Media Map shown below) take the ID of the application to open as a URL parameter.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1932642,"id":1932642,"title":"urlpa-1","filename":"urlpa-1.png","filesize":7516,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-1.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/using-url-parameters-in-web-apps\/urlpa-1","alt":"Instant App URL syntax","author":"7641","description":"","caption":"","name":"urlpa-1","status":"inherit","uploaded_to":68891,"date":"2023-05-15 18:57:41","modified":"2023-05-15 18:58:08","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":743,"height":50,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-1-213x50.png","thumbnail-width":213,"thumbnail-height":50,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-1.png","medium-width":464,"medium-height":31,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-1.png","medium_large-width":743,"medium_large-height":50,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-1.png","large-width":743,"large-height":50,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-1.png","1536x1536-width":743,"1536x1536-height":50,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-1.png","2048x2048-width":743,"2048x2048-height":50,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-1.png","card_image-width":743,"card_image-height":50,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-1.png","wide_image-width":743,"wide_image-height":50}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

To include multiple parameters, separate them with ampersands (&).<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1932892,"id":1932892,"title":"urlpa-2","filename":"urlpa-2.png","filesize":6750,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-2.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/using-url-parameters-in-web-apps\/urlpa-2","alt":"Multiple URL parameters","author":"7641","description":"","caption":"","name":"urlpa-2","status":"inherit","uploaded_to":68891,"date":"2023-05-15 19:56:17","modified":"2023-05-15 19:56:30","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":757,"height":49,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-2-213x49.png","thumbnail-width":213,"thumbnail-height":49,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-2.png","medium-width":464,"medium-height":30,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-2.png","medium_large-width":757,"medium_large-height":49,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-2.png","large-width":757,"large-height":49,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-2.png","1536x1536-width":757,"1536x1536-height":49,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-2.png","2048x2048-width":757,"2048x2048-height":49,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-2.png","card_image-width":757,"card_image-height":49,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2015\/08\/urlpa-2.png","wide_image-width":757,"wide_image-height":49}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

 <\/p>\n

URL encoding<\/strong><\/p>\n

URL encoding replaces characters with the percent sign (%) followed by their hex (hexadecimal) equivalent. In modern browsers, URL encoding is automatically added as needed when entering a URL in the browser address bar. When using embedded apps, encoding will be necessary.<\/p>\n

For example, the following is an example using Basic Instant App that uses find<\/strong> to locate Redlands California. The space in the location is automatically replaced by %20 in the browser address bar:<\/p>\n

https:\/\/www.arcgis.com\/apps\/instant\/basic\/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a&find=redlands california<\/strong><\/p>\n

https:\/\/www.arcgis.com\/apps\/instant\/basic\/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a&find=redlands%20california<\/strong><\/p>\n

The full URL encoding is as follows:<\/p>\n

https%3A%2F%2Fwww.arcgis.com%2Fapps%2Finstant%2Fbasic%2Findex.html
\n%3Fappid%3D3ad44ff5f69047a29742cdd0c418a74a%26find%3Dredlands%20california<\/strong><\/p>\n

For more information, and to encode your strings, see URLEncoder.io<\/a><\/p>\n"},{"acf_fc_layout":"content","content":"

 <\/p>\n

Examples<\/h2>\n

The following examples use Basic Instant App. Media Map supports the same parameters. Other apps will differ; experiment to see which parameters work in your chosen app.<\/p>\n

Open the app as configured<\/strong><\/p>\n

The app is referenced by its ID, in this case 3ad44ff5f69047a29742cdd0c418a74a.<\/p>\n

https:\/\/www.arcgis.com\/apps\/instant\/basic\/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a<\/a><\/p>\n

Specify a scale level<\/strong><\/p>\n

Scale is specified using &level=<LOD>.<\/p>\n

https:\/\/www.arcgis.com\/apps\/instant\/basic\/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a&level=10<\/a><\/p>\n

Specify a location and scale level<\/strong><\/p>\n

The map is centered using &center=<x>,<y>.<\/p>\n

https:\/\/www.arcgis.com\/apps\/instant\/basic\/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a&center=-75.164422,39.954757&level=14<\/a><\/p>\n

Specify an extent<\/strong><\/p>\n

&Extent uses two x,y coordinates to define the bounding box.<\/p>\n

https:\/\/www.arcgis.com\/apps\/instant\/basic\/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a&extent=-117.20,34.055,-117.19,34.06<\/a><\/p>\n

Find a location of a feature to open the app<\/strong><\/p>\n

Use &find= followed by any search string.<\/p>\n

https:\/\/www.arcgis.com\/apps\/instant\/basic\/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a&find=Niagara Falls<\/a><\/p>\n

Find an address to open the app<\/strong><\/p>\n

https:\/\/www.arcgis.com\/apps\/instant\/basic\/index.html?appid=3ad44ff5f69047a29742cdd0c418a74a&find=380 new york street, redlands, ca<\/a><\/p>\n

Add a marker with a pop-up<\/strong><\/p>\n

&Marker uses the following properties. To skip a property use double semicolons (;;). The marker properties must be in this order: \u00a0&marker=<x>,<y>,<WKID>,<title>,<symbol URL>,<text><\/span>. Click the marker to view the pop-up.<\/p>\n