Fügt der aktuellen Zeichnung unter Verwendung der angegebenen Service-Eigenschaften einen Karten- oder Bilddaten-Layer hinzu. Der Layer verwendet das aktuelle Koordinatensystem der Zeichnung, der er hinzugefügt wurde. Wenn der Layer einer Zeichnung hinzugefügt wird, die kein Koordinatensystem enthält, übernimmt die Zeichnung das Koordinatensystem vom Layer.
Syntax
(esri_maplayer_add url service_properties)
Argumente
- url | Zeichenfolge | erforderlich | Ein gültiger Pfad zu einem Karten- oder Bild-Layer von ArcGIS.
- service_properties | Assoziationsliste | optional | Eine Assoziationsliste der Eigenschaften des Karten-Service in Form von Paarlisten (dotted pairs), die wie folgt definiert sind:
Assoziierte Bezeichnung Wertetyp Wertbeschreibung Erforderlich oder optional "TRANSPARENCY" Integer
Auf die Karte anzuwendende, prozentual ausgedrückte Bildtransparenz: {0-99: zero is opaque} (Standardwert = 30)
Optional
Beispiel für die Verwendung
Versucht, den Karten- oder Bild-Layer mit einer Transparenz von 70 % über die angegebene URL hinzuzufügen:(esri_maplayer_add "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Water_Network/MapServer"
(list
(cons "TRANSPARENCY" 70)
)
)
Ergebnis des Beispiels für die Verwendung
Fügt den Karten-Layer hinzu und gibt eine Liste zurück, die die neue Karten-Layer-Indexnummer enthält:(1)
Rückgabewerte
Von dieser Funktion wird ein Wert zurückgegeben.
- Gibt bei erfolgreicher Ausführung eine Liste zurück, die die neue Karten-Layer-Indexnummer enthält.
- Wenn bei dem Vorgang ein Fehler auftritt, wird eine Liste zurückgegeben, in der der erste Wert nil lautet. Anschließend wird eine Assoziationsliste mit dem Schlüsselwert Error sowie eine entsprechende Fehlermeldung in Form einer Zeichenfolge zurückgegeben: (nil ( "Error" . "<message>")).
Rückgabewerte mit Fehlern
Ein Rückgabewert mit einem Fehler kann eine der folgenden Ursachen haben:
- (nil ("Error" . "Invalid URL"))
Die angegebene URL ist ungültig.
- (nil ("Error" . "Error adding layer."))
Ein Karten-Layer konnte über die angegebene URL nicht hinzugefügt werden.
- (nil ("Error" . "Missing required argument."))
Mindestens eines der erforderlichen Argumente wurde nicht angegeben.