Skip To Content

esri_maplayer_addasync (AutoLISP)

Fügt der aktuellen Zeichnung asynchron und unter Verwendung der angegebenen Service-Eigenschaften einen Karten- oder Bilddaten-Layer hinzu. Der Prozess wird außerhalb des AutoLISP-Prozesses ausgeführt. Sie erhalten kein weiteres Feedback. Verwenden Sie esri_maplayer_add zum Hinzufügen von Karten- oder Bilddaten-Layern mit Feedback zum Ergebnis. 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_map_addasync url service_properties)

Argumente

  • url | Zeichenfolge | erforderlich | Ein gültiger Pfad zu einem Karten- oder Bilddaten-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 BezeichnungWertetypWertbeschreibungErforderlich 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 Bilddaten-Layer mit einer Transparenz von 70 % über die angegebene URL hinzuzufügen:

(esri_maplayer_addasync "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Water_Network/MapServer"
  (list
  (cons "TRANSPARENCY" 70)
  )
)

Ergebnis des Beispiels für die Verwendung

Versucht, den angegebenen Layer hinzuzufügen. Die Funktion wartet nicht auf Feedback zum Erfolg oder Fehler und gibt eine Liste mit "true" zurück:

(T)

Rückgabewerte

  • Bei erfolgreicher Ausführung wird eine Liste mit "true" zurückgegeben: (T)
  • 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:

  • (nil ("Error" . "Missing required argument."))

    Das erforderliche Argument wurde nicht angegeben.

  • (nil ("Error" . "This command requires a network connection."))

    Zur Ausführung der Funktion ist eine Netzwerkverbindung mit der Quelle des Web-Layers erforderlich.

  • (nil ("Error" . "Invalid URL."))

    Die angegebene URL ist ungültig.