URL-Parameter

Initialisieren des Viewers mit URL-Parametern

ArcGIS Viewer for Silverlight lässt die Festlegung bestimmter Initialisierungsparameter in der Abfragezeichenfolge der URL einer bereitgestellten Viewer-Anwendung zu. Diese Parameter ermöglichen die Festlegung der Anfangsausdehnung, des Maßstabs, der Maßstabsebene, der Webkarte und Ortssuche eines Viewers, ohne die Konfiguration dieses Viewers zu ändern. Jeder Parameter wird durch die Einbeziehung eines bestimmten Schlüsselwertpaares in die Abfragezeichenfolge festgelegt. Die Auswirkungen und Syntax der einzelnen Parameter werden nachfolgend beschrieben.

Webkarte

Der Parameter webmap bewirkt, dass der Viewer die angegebene Webkarte anzeigt. Um diesen Parameter zu verwenden, geben Sie das Schlüsselwertpaar webmap=id in die Abfragezeichenfolge ein, wobei id die eindeutige Kennung der Webkarte ist. Beachten Sie, dass beim Laden des Viewers eine Anmeldeaufforderung angezeigt wird, wenn eine nicht öffentlich freigegebene Webkarte angegeben wird. Eine Viewer-URL, für die dieser Parameter angegeben wurde, sieht in etwa wie folgt aus:

// Load the Esri Atlas Geology web map
http://www.example.com/apps/myviewer/index.htm?webmap=74a8f6645ab44c4f82d537f1aa0e375d

Ortssuche

Der Parameter search bewirkt, dass das Suchwerkzeug des Viewers, eine Ortssuche ausführt, sobald die Viewer-Anwendung geladen wird. Um diesen Parameter zu verwenden, geben Sie das Schlüsselwertpaar search=place in die Abfragezeichenfolge ein, wobei place den zu suchenden Ort, beispielsweise eine Adresse, Stadt, Landmark oder den Namen eines Unternehmens, beschreibt. Die folgenden URLs veranschaulichen die Verwendungsmöglichkeiten dieses Parameters:

// Search for Redlands, CA
http://www.example.com/apps/myviewer/index.htm?search=Redlands,California,United States

// Search for the Eiffel Tower
http://www.example.com/apps/myviewer/index.htm?search=Eiffel Tower

// Search for ESRI
http://www.example.com/apps/myviewer/index.htm?search=ESRI

Ausdehnung

Der Parameter extent bewirkt, dass die Karte des Viewers mit der angegebenen Ausdehnung geladen wird. Um diesen Parameter zu verwenden, geben Sie das Schlüsselwertpaar extent=xmin,ymin,xmax,ymax,wkid in die Abfragezeichenfolge ein, wobei xmin die linke Koordinate der Ausdehnung, ymin die untere Koordinate der Ausdehnung, xmax die rechte Koordinate der Ausdehnung, ymax die obere Koordinate der Ausdehnung und wkid der Well-Known Identifier des Raumbezugs der Ausdehnung darstellt. Wenn sich die Koordinaten im selben Raumbezug wie die Karte des Viewers befinden, kann wkid weggelassen werden. Nachfolgend finden Sie Beispiele von Viewer-URLs, für die dieser Parameter angegeben wurde:

// Set map extent to Greater Copenhagen area, assuming the map is in the same spatial 
// reference as the coordinates
http://www.example.com/apps/myviewer/index.htm?extent=1220000,7364000,1632000,7632000

// Set map extent to Greater Copenhagen area using coordinates in WGS 84 (WKID 4326)
http://www.example.com/apps/myviewer/index.htm?extent=14.70,51.76,12.66,59.37,4326

Skalieren

Der Parameter scale bewirkt, dass die Karte des Viewers mit dem angegebenen Maßstab geladen wird. Um diesen Parameter zu verwenden, geben Sie das Schlüsselwertpaar scale=<scale> in die Abfragezeichenfolge ein, wobei <scale> der Nenner des gewünschten Maßstabs ist. Wenn beispielsweise ein Maßstab von 1/24000 gewünscht wird, sollte <scale> auf 24000 festgelegt werden. Dieser Parameter kann, wie unten dargestellt, angegeben werden:

// Set map scale to 1/100,000
http://www.example.com/apps/myviewer/index.htm?scale=100000

Maßstabsebene

Der Parameter level bewirkt, dass die Karte des Viewers auf einer Detaillierungsebene geladen wird, die im gekachelten Karten-Service definiert wurde, der als Grundkarte der Karte verwendet wird. Um diesen Parameter zu verwenden, geben Sie das Schlüsselwertpaar level=levelid in die Abfragezeichenfolge ein, wobei levelid die ID der gewünschten Detaillierungsebene ist, die im gekachelten Karten-Service definiert wurde. Eine URL, in die dieser Parameter einbezogen wurde, sieht in etwa wie folgt aus:

// Initialize the map to the level of detail with an ID of 10
http://www.example.com/apps/myviewer/index.htm?level=10

Kombinieren von URL-Parametern

Viele der vom Viewer unterstützten URL-Parameter können kombiniert werden. Es kann beispielsweise hilfreich sein, einen Maßstab zusammen mit einem Mittelpunkt anzugeben. Um Parameter zu kombinieren, trennen Sie einfach die Schlüsselwertpaare, die die einzelnen Parameter definieren, durch ein kaufmännisches Und-Zeichen (&). Hier finden Sie ein Beispiel:

// Center on Singapore at a map scale of 1/300,000
http://www.example.com/apps/myviewer/index.htm?center=11563270,144180&scale=300000