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 maps, encoding may be necessary.<\/p>\n
For example, the following is an example that uses find<\/strong>\u00a0to 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\/mapviewer\/index.html? https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&find=redlands%20california<\/strong><\/p>\n The full URL encoding is as follows:<\/p>\n https%3A%2F%2Fwww.arcgis.com%2Fapps%2Fmapviewer%2Findex.html For more information, and to encode your URL strings, see URLEncoder.io<\/a><\/p>\n"},{"acf_fc_layout":"content","content":" <\/p>\n The following examples show using URL parameters to open and modify maps.<\/p>\n Open an existing map as configured<\/strong><\/p>\n The map is referenced by its ID, in this case 8152694dd9594393a1db4d62d2020fe3.<\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3<\/a><\/p>\n Open an existing map and specify a scale level<\/strong><\/p>\n Scale is specified using &level=<LOD><\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&level=9<\/a><\/p>\n Specify a location and scale level<\/strong><\/p>\n The map is centered using ¢er=<x>,<y>.<\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3¢er=-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\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&extent=-117.20,34.055,-117.19,34.06<\/a><\/p>\n Find the location of a feature to open the map<\/strong><\/p>\n Use &find= followed by any search string.<\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&find=Niagara Falls<\/a><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1939222,"id":1939222,"title":"urlpmv-7","filename":"urlpmv-7.png","filesize":298457,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-7.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/use-url-parameters-in-map-viewer\/urlpmv-7","alt":"Find location via URL parameters","author":"7641","description":"","caption":"","name":"urlpmv-7","status":"inherit","uploaded_to":1936712,"date":"2023-05-21 18:04:25","modified":"2023-05-21 18:04:41","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":561,"height":395,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-7-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-7.png","medium-width":371,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-7.png","medium_large-width":561,"medium_large-height":395,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-7.png","large-width":561,"large-height":395,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-7.png","1536x1536-width":561,"1536x1536-height":395,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-7.png","2048x2048-width":561,"2048x2048-height":395,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-7.png","card_image-width":561,"card_image-height":395,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-7.png","wide_image-width":561,"wide_image-height":395}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" Find an address to open the map<\/strong><\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&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 https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&marker=-118.292176;36.578494;;Mount Whitney;https:\/\/downloads.esri.com\/agol\/resources\/symbols\/misc\/rm1.png;Mount Whitney is the highest mountain in the contiguous United States with an elevation of 14,505 feet (4,421 m).<\/a><\/p>\n Add a marker with a pop-up and specify a zoom level<\/strong><\/p>\n Add &level to the URL above. Click the marker to view the pop-up.<\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3&marker=-118.292176;36.578494;;Mount Whitney;https:\/\/downloads.esri.com\/agol\/resources\/symbols\/misc\/rm1.png;Mount Whitney is the highest mountain in the contiguous United States with an elevation of 14,505 feet (4,421 m).&level=14<\/a><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1939092,"id":1939092,"title":"urlpmv-3","filename":"urlpmv-3.png","filesize":113749,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-3.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/use-url-parameters-in-map-viewer\/urlpmv-3","alt":"URL parameters to create pop-up","author":"7641","description":"","caption":"","name":"urlpmv-3","status":"inherit","uploaded_to":1936712,"date":"2023-05-19 23:25:37","modified":"2023-05-19 23:26:03","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":516,"height":260,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-3-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-3.png","medium-width":464,"medium-height":234,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-3.png","medium_large-width":516,"medium_large-height":260,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-3.png","large-width":516,"large-height":260,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-3.png","1536x1536-width":516,"1536x1536-height":260,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-3.png","2048x2048-width":516,"2048x2048-height":260,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-3.png","card_image-width":516,"card_image-height":260,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-3.png","wide_image-width":516,"wide_image-height":260}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" Open a map and add layers<\/strong><\/p>\n This example opens a map and adds Recent Earthquakes<\/a> and VIIRS Thermal Hotspots<\/a> from ArcGIS Living Atlas<\/a>. Use the &layers parameter to add the layers using their IDs, separated by a comma.<\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?webmap=8152694dd9594393a1db4d62d2020fe3 Open Map Viewer and define the basemap<\/strong><\/p>\n Set basemapUrl to the basemap layer you want to use. Note the capitalization of U in the parameter. This examples opens with the OpenStreetMap (OSM) vector basemap layer. Add the &level parameter to zoom in.<\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?basemapUrl=https:\/\/basemaps.arcgis.com\/arcgis\/rest\/services\/OpenStreetMap_v2\/VectorTileServer<\/a><\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?basemapUrl=https:\/\/basemaps.arcgis.com\/arcgis\/rest\/services\/OpenStreetMap_v2\/VectorTileServer&level=3<\/a><\/p>\n Open Map Viewer, define the basemap, and add a layer<\/strong><\/p>\n This example opens the OSM vector basemap layer and adds Recent Earthquakes<\/a> (from ArcGIS Living Atlas<\/a>) using the item ID with the &layers parameter.<\/b><\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?basemapUrl=https:\/\/basemaps.arcgis.com\/arcgis\/rest\/services\/OpenStreetMap_v2\/VectorTileServer Open Map Viewer, add a basemap and reference layer<\/strong><\/p>\n Use basemapReferenceUrl to set the reference layer to be used. This must be used along with basemapUrl. The example below adds the World Boundaries and Places reference layer to the Vintage Shaded Relief<\/a> basemap layer, both from ArcGIS Living Atlas.<\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?basemapUrl=https:\/\/tiles.arcgis.com\/tiles\/nGt4QxSblgDfeJn9\/arcgis\/rest\/services\/VintageShadedRelief\/MapServer Set sublayer visibility<\/strong><\/p>\n To set the visibility of sublayers for a layer that opened in the map, use layers=show. In this example using Bureau of Labor Statistics Unemployment<\/a> from the Living Atlas, only the 3rd sublayer is visible. Note that sublayer numbering begins with zero (0) as shown in the REST endpoint.<\/span><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1939182,"id":1939182,"title":"urlpmv-6","filename":"urlpmv-6.png","filesize":4787,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-6.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/use-url-parameters-in-map-viewer\/urlpmv-6","alt":"Layers in REST endpoint","author":"7641","description":"","caption":"","name":"urlpmv-6","status":"inherit","uploaded_to":1936712,"date":"2023-05-21 17:51:07","modified":"2023-05-21 17:51:24","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":195,"height":151,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-6.png","thumbnail-width":195,"thumbnail-height":151,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-6.png","medium-width":195,"medium-height":151,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-6.png","medium_large-width":195,"medium_large-height":151,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-6.png","large-width":195,"large-height":151,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-6.png","1536x1536-width":195,"1536x1536-height":151,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-6.png","2048x2048-width":195,"2048x2048-height":151,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-6.png","card_image-width":195,"card_image-height":151,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-6.png","wide_image-width":195,"wide_image-height":151}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?url=https:\/\/services.arcgis.com\/P3ePLMYs2RVChkJx\/arcgis\/rest\/services\/BLS_Monthly_Unemployment_Current_14_Months\/FeatureServer?layers=show:2&find=Pennsylvania<\/a><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1939162,"id":1939162,"title":"urlpmv-5","filename":"urlpmv-5.png","filesize":77485,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-5.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/use-url-parameters-in-map-viewer\/urlpmv-5","alt":"Sublayer visibility using URL parameters","author":"7641","description":"","caption":"","name":"urlpmv-5","status":"inherit","uploaded_to":1936712,"date":"2023-05-20 18:23:24","modified":"2023-05-20 18:23:39","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":705,"height":299,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-5-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-5.png","medium-width":464,"medium-height":197,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-5.png","medium_large-width":705,"medium_large-height":299,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-5.png","large-width":705,"large-height":299,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-5.png","1536x1536-width":705,"1536x1536-height":299,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-5.png","2048x2048-width":705,"2048x2048-height":299,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-5.png","card_image-width":705,"card_image-height":299,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-5.png","wide_image-width":705,"wide_image-height":299}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" Add two layers and set sublayer visibility<\/strong><\/p>\n This example adds two layers and sets the visibility of sublayers for the second layer. The layers are separated by commas, note that the additional URL parameters for sublayer visibility apply to the second layer, plus the addition of an overall extent parameter which controls the map.<\/p>\n https:\/\/www.arcgis.com\/apps\/mapviewer\/index.html?urls=https:\/\/services9.arcgis.com\/RHVPKKiFTONKtxq3\/arcgis\/rest\/services\/NOAA_METAR_current_wind_speed_direction_v1\/FeatureServer, <\/p>\n For more information, see:<\/p>\n <\/p>\n"}],"related_articles":"","authors":[{"ID":7641,"user_firstname":"Bernie","user_lastname":"Szukalski","nickname":"Bern Szukalski","user_nicename":"bszukalski","display_name":"Bern Szukalski","user_email":"bszukalski@esri.com","user_url":"","user_registered":"2018-03-26 17:55:14","user_description":"I am a corporate technology evangelist and geo advocate at Esri, focusing on ways to broaden access to geographic information and helping customers succeed with ArcGIS. \r\n\r\nOn a good day I'm making a map, on a great day I'm on one. Email bszukalski@esri.com or connect on LinkedIn (https:\/\/www.linkedin.com\/in\/bernszukalski\/).","user_avatar":"
\nwebmap=8152694dd9594393a1db4d62d2020fe3&find=redlands california<\/strong><\/p>\n
\n%3Fwebmap%3D8152694dd9594393a1db4d62d2020fe3%26find%3Dredlands%20california<\/strong><\/p>\nExamples<\/h2>\n
\n
\n&layers=9e2f2b544c954fda9cd13b7f3e6eebce,dece90af1a0242dcbf0ca36d30276aa3<\/a><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1939062,"id":1939062,"title":"urlpmv-2","filename":"urlpmv-2.png","filesize":181595,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-2.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/use-url-parameters-in-map-viewer\/urlpmv-2","alt":"Layers added via URL parameters","author":"7641","description":"","caption":"","name":"urlpmv-2","status":"inherit","uploaded_to":1936712,"date":"2023-05-19 23:19:13","modified":"2023-05-19 23:19:34","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":752,"height":352,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-2-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-2.png","medium-width":464,"medium-height":217,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-2.png","medium_large-width":752,"medium_large-height":352,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-2.png","large-width":752,"large-height":352,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-2.png","1536x1536-width":752,"1536x1536-height":352,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-2.png","2048x2048-width":752,"2048x2048-height":352,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-2.png","card_image-width":752,"card_image-height":352,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-2.png","wide_image-width":752,"wide_image-height":352}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"
\n&layers=9e2f2b544c954fda9cd13b7f3e6eebce<\/a><\/p>\n
\n&basemapReferenceUrl=https:\/\/services.arcgisonline.com\/ArcGIS\/rest\/services\/Reference\/World_Boundaries_and_Places\/MapServer
\n&level=3<\/a><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1939152,"id":1939152,"title":"urlpmv-4","filename":"urlpmv-4.png","filesize":454965,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-4.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/use-url-parameters-in-map-viewer\/urlpmv-4","alt":"Basemap and reference via URL parameters","author":"7641","description":"","caption":"","name":"urlpmv-4","status":"inherit","uploaded_to":1936712,"date":"2023-05-20 17:37:18","modified":"2023-05-20 17:37:37","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":752,"height":308,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-4-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-4.png","medium-width":464,"medium-height":190,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-4.png","medium_large-width":752,"medium_large-height":308,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-4.png","large-width":752,"large-height":308,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-4.png","1536x1536-width":752,"1536x1536-height":308,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-4.png","2048x2048-width":752,"2048x2048-height":308,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-4.png","card_image-width":752,"card_image-height":308,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-4.png","wide_image-width":752,"wide_image-height":308}},"image_position":"left-center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"
\nhttps:\/\/services9.arcgis.com\/RHVPKKiFTONKtxq3\/arcgis\/rest\/services\/NOAA_storm_reports_v1\/FeatureServer
\n?layers=show:4&extent=-108,40,-85,31<\/a><\/p>\n"},{"acf_fc_layout":"content","content":"More information<\/h2>\n
\n
"}],"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-c.jpg","wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/05\/urlpmv-b.png"},"yoast_head":"\n