URL-parameters gebruiken

Kaarten die zijn gemaakt met de ArcGIS.com-map viewer bevatten een basiskaart, gegevenslagen, een extent, een legenda en navigatietools, zoals zoomen, pannen, locatiezoekers en bladwijzers. Heel wat kaarten bevatten ook interactieve elementen, zoals een basiskaartgalerij waarmee u kunt schakelen tussen kaarten, zoals satellietbeelden en straten, plus meettools, pop-ups die attributen van een specifiek object tonen en knoppen voor het weergeven van gegevens over een bepaalde periode.

Naast het maken van kaarten met de ArcGIS.com-map viewer kunt u ook rechtstreeks kaarten maken met URL-parameters. Met URL-parameters kunt u de inhoud van een kaart definiëren, bijvoorbeeld de basiskaart, operationele lagen en het extent.

Dit is een voorbeeld van hoe u een kaart kunt maken met URL-parameters die windmolenparken op het land weergeven binnen het Verenigd Koninkrijk.

http://www.arcgis.com/home/webmap/viewer.html?basemapUrl=http%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer&url=http%3A%2F%2Fservices.arcgis.com%2FWQ9KVmV6xGGMnCiQ%2Farcgis%2Frest%2Fservices%2FOnshore_Windfarms%2FFeatureServer&extent=-24.3161%2C45.2274%2C18.0911%2C63.5381

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Opmerking:

Alle queryparameters moeten worden gecodeerd. Het coderen van URL's zorgt ervoor dat er geldige tekens naar ArcGIS Online worden verzonden. Door te coderen worden ongeldige tekens vervangen door %, gevolgd door hun hexadecimale equivalent.

Dit is een voorbeeld van een niet-gecodeerde URL-parameter:

basemapUrl=http://services.arcgisonline.com/ArcGIS/rest/services/Ocean_Basemap/MapServer

Dit is dezelfde parameter, maar dan gecodeerd:

basemapUrl=http%3A%2F%2Fservices.arcgisonline.com%2FArcGIS%2Frest%2Fservices%2FOcean_Basemap%2FMapServer

Parameters binnen parameters moeten ook worden gecodeerd. Bijvoorbeeld

urls=http%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Ftrackline_gravity%2FMapServer%2Chttp%3A%2F%2Fmaps.ngdc.noaa.gov%2Frest%2Fservices%2Fweb_mercator%2Fhazards%2FMapServer%3Flayers%3Dshow%3A5%2C6

Op internet vindt u veel gratis sites en hulpmiddelen voor het maken van gecodeerde URL's. Albion Research Ltd. beschikt bijvoorbeeld over een pagina voor het coderen en decoderen van URL's: URLEncode and URLDecode Page. Voor de leesbaarheid is de rest van de voorbeelden in dit onderwerp niet gecodeerd. Klik op de koppeling Dit voorbeeld weergeven in de ArcGIS.com-map viewer na het voorbeeld om de gecodeerde URL in een webbrowser te zien.

De URL begint altijd met het volgende:

http://www.arcgis.com/home/webmap/viewer.html?

De URL bevat ook een of meer van de hieronder weergegeven queryparameters.

Om meer dan één parameter op te nemen, moet u een ampersand (&) gebruiken om de parameters te scheiden.

Bijvoorbeeld

http://www.arcgis.com/home/webmap/viewer.html?center=20,45&level=4

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Definieer de basiskaart die wordt gebruikt in de viewer.

Stel basemapUrl= in op de kaartlaag. Als er geen basiskaart is gedefinieerd, zal de standaardbasiskaart de Topografische wereldkaart zijn. Bijvoorbeeld

http://www.arcgis.com/home/webmap/viewer.html?
     basemapUrl=http://services.arcgisonline.com/ArcGIS/rest/services/World_Physical_Map/MapServer

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Neem een referentielaag op binnen de basemap. Deze moet worden gebruikt naast de basemap-URL.

Stel basemapReferenceUrl= in op de kaartlaag. Bijvoorbeeld

http://www.arcgis.com/home/webmap/viewer.html?
basemapUrl=http://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer
&basemapReferenceUrl=http://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places/MapServer

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Definieer de operationele lagen die als overlay op de basiskaart worden gelegd.

Gebruik webmap=, url= of urls=.

De webmap=-parameter accepteert de item-ID van een opgeslagen kaart. Bijvoorbeeld

http://www.arcgis.com/home/webmap/viewer.html?webmap=2def3f0c7be74f05af33ac87b8d03ef2

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

De url=-parameter accepteert een enkelvoudige kaartlaag-URL. Bijvoorbeeld

http://www.arcgis.com/home/webmap/viewer.html?
     url=http://services.arcgisonline.com/ArcGIS/rest/services/Demographics/USA_Population_Density/MapServer

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Gebruik urls= om meer dan één kaartlaag op te nemen. Scheid kaartlagen van elkaar door een komma. Het kaartextent is gebaseerd op de laatste kaartlaag in de lijst of degene die het traagst wordt geladen. Neem de extent=-parameter op om naar een bepaalde extent te zoomen. Bijvoorbeeld

http://www.arcgis.com/home/webmap/viewer.html?urls=http://maps.ngdc.noaa.gov/rest/services/web_mercator/trackline_gravity/MapServer,http://maps.ngdc.noaa.gov/rest/services/web_mercator/hazards/MapServer?layers=show:5,6,12&extent=5,45,10,50

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

centreer de kaart op een specifieke locatie.

Stel center= in met de geografische coördinaten (x,y) of geprojecteerde coördinaten (x,y,WKID).

Voorbeeld geografische coördinaten

http://www.arcgis.com/home/webmap/viewer.html?center=20,45

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Voorbeeld geprojecteerde coördinaten

http://www.arcgis.com/home/webmap/viewer.html?center=500000,5500000,102100

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Definieer het schaalniveau van de map viewer.

Gebruik de center-parameter en level=. De level-parameter accepteert de niveau-ID van de cacheschaal zoals weergegeven in het eindpunt van de REST-service. Het cacheschaalniveau kan worden vastgesteld met de informatie op het REST-eindpunt van de mapservice. De resolutie is omgekeerd evenredig met de schaal.

Opmerking:

De schaal wordt automatisch ingesteld wanneer u de webmap- of find-parameter gebruikt. level wordt genegeerd. Als u de webmap-parameter gebruikt, wordt de kaart automatisch weergegeven met de volledige extent van de kaart. Als u de find-parameter gebruikt, wordt de kaart automatisch weergegeven met de beste extent van de gevonden locatie.

Voorbeeld geografische coördinaten

http://www.arcgis.com/home/webmap/viewer.html?center=20,45&level=4

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Voorbeeld geprojecteerde coördinaten

http://www.arcgis.com/home/webmap/viewer.html?center=500000,5500000,102100&level=4

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Definieer het extent van de kaart.

Gebruik extent= om het extent van de kaart te definiëren. De extent-parameter accepteert geografische coördinaten (GCS) zoals MinX,MinY,MaxX,MaxY of geprojecteerde coördinaten (PCS) als MinX,MinY,MaxX,MaxY,WKID.

Voorbeeld geografische coördinaten

http://www.arcgis.com/home/webmap/viewer.html?extent=-117.20,34.055,-117.19,34.06

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Voorbeeld geprojecteerde coördinaten

http://www.arcgis.com/home/webmap/viewer.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Stel de zichtbaarheid van de lagen in de kaart in.

Gebruik layers=show:. Bijvoorbeeld

http://www.arcgis.com/home/webmap/viewer.html?url=http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/BloomfieldHillsMichigan/Parcels/MapServer?layers=show:1,2

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.

Zoek een locatie die wordt gebruikt om de kaart te openen. De kaart wordt automatisch gezoomd naar de treffer die het nauwst aanleunt bij uw zoekactie en er wordt een bijschriftmarkering toegevoegd aan uw kaart.

Gebruik find=. De find-parameter accepteert adressen van één regel, gedeeltelijke adressen (zoals alleen de plaats of alleen het land), plaatsnamen en coördinaten van de breedtegraad-lengtegraad. Bijvoorbeeld

http://www.arcgis.com/home/webmap/viewer.html?find=380 new york st,redlands,ca

Bekijk dit voorbeeld in de ArcGIS.com-map viewer.