Diese Funktion legt eine Datumstransformation in der aktuellen Zeichnung fest. Wenn die Datumstransformation (Ausgangs- und Zielkoordinatensysteme) bereits vorhanden ist, wird sie überschrieben. Die Funktion gibt die festgelegte Datumstransformation zurück.
Syntax
(esri_coordsys_DatumTransformations_set FromCS ToCS transformationStep_properties)
Argumente
- FromCS | Zeichenfolge | erforderlich | Gültige WKID (Well-Known-Koordinatensystem-Identifikationsnummer) oder WKT des Esri Koordinatensystems als Zeichenfolge.
- ToCS | Zeichenfolge | erforderlich | Gültige WKID (Well-Known-Koordinatensystem-Identifikationsnummer) oder WKT des Esri Koordinatensystems als Zeichenfolge.
transformationStep_properties | Assoziationsliste | erforderlich | Ein Liste von Transformationsschritten als Assoziationslisten von zwei Schritteigenschaften in Form von Paarlisten, wie sie in der folgenden Tabelle definiert sind:
Assoziierte Bezeichnung Wertetyp Wertbeschreibung Erforderlich oder optional "Direction" string
Die Richtung des Schritts, die entweder "Forward" oder "Reverse" ist, je nachdem, in welche Richtung der Transformationsschritt angewendet werden soll.
required
"Step"
string
Die WKID oder der WKT des Transformationsschritts.
required
Verwendung
Beim Erstellen einer kombinierten Datumstransformation muss die Reihenfolge der einzelnen Schritte korrekt sein. Unten im Beispiel 2 ist zum Beispiel 108355 der erste Schritt und 108282 der zweite und letzte Schritt. Die Richtung muss in Form der Zeichenfolgen "Forward" oder "Reverse" angegeben werden. Dabei wird die Groß- und Kleinschreibung nicht beachtet.
ArcGIS for AutoCAD überprüft die angegebenen Transformationsschritte nicht. Wenn ein Teil der festgelegten Methode ungültig ist oder in der falschen Reihenfolge angewendet wird, stellt ArcGIS for AutoCAD die Layer möglicherweise nicht korrekt dar.
Hinweis:
Beim Erstellen eines Well-Known-Text (WKT) als AutoLISP-Zeichenfolgenargument muss die Zeichenfolge die korrekten Escape-Zeichen enthalten, um die notwendigen Anführungszeichen in die Textzeichenfolge einzubinden. Nachfolgend finden Sie einige Beispiele:
Koordinatensystem:
"PROJCS[\"NAD_1983_HARN_StatePlane_Florida_West_FIPS_0902_Feet\",GEOGCS[\"GCS_North_American_1983_HARN\",DATUM[\"D_North_American_1983_HARN\",SPHEROID[\"GRS_1980\",6378137.0,298.257222101]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Transverse_Mercator\"],PARAMETER[\"False_Easting\",656166.6666666665],PARAMETER[\"False_Northing\",0.0],PARAMETER[\"Central_Meridian\",-82.0],PARAMETER[\"Scale_Factor\",0.9999411764705882],PARAMETER[\"Latitude_Of_Origin\",24.33333333333333],UNIT[\"Foot_US\",0.3048006096012192],AUTHORITY[\"EPSG\",2882]]"Datumstransformation
"GEOGTRAN[\"WGS_1984_(ITRF00)_To_NAD_1983\",GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],GEOGCS[\"GCS_North_American_1983\",DATUM[\"D_North_American_1983\",SPHEROID[\"GRS_1980\",6378137.0,298.257222101]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],METHOD[\"Coordinate_Frame\"],PARAMETER[\"X_Axis_Translation\",0.9956],PARAMETER[\"Y_Axis_Translation\",-1.9013],PARAMETER[\"Z_Axis_Translation\",-0.5215],PARAMETER[\"X_Axis_Rotation\",0.025915],PARAMETER[\"Y_Axis_Rotation\",0.009426],PARAMETER[\"Z_Axis_Rotation\",0.011599],PARAMETER[\"Scale_Difference\",0.00062],OPERATIONACCURACY[0.1]]"Beispiel 1 für die Verwendung
Versucht, eine Datumstransformation in einem einzelnen Schritt in der aktuellen Zeichnung zwischen den durch die WKID angegebenen Ausgangs- und Ziel-Koordinatensystemen festzulegen. Die Liste der Schritte enthält einen einzelnen Datumstransformationsschritt, der eine WKID referenziert und in der Vorwärtsreihenfolge angewendet werden sollte.(esri_coordsys_DatumTransformations_set
"2882" "3857"
(list
(list (cons "Direction" "Forward") (cons "Step" 1580))
)
)
Ergebnis des Beispiels 1 für die Verwendung
Legt die Datumstransformation in einem einzelnen Schritt in der aktuellen Zeichnung fest und gibt die gesamte Definition der Datumstransformation als Assoziationsliste zurück.
(("From" . "2882") ("To" . "3857") ("Transformation" ((("Direction" . "Forward") ("Step" . "1580")))))Beispiel 2 für die Verwendung
Versucht, eine kombinierte Datumstransformation in der aktuellen Zeichnung zwischen den durch die WKID (Well-Known-Identifikationsnummer) angegebenen Ausgangs- und Ziel-Koordinatensystemen festzulegen. Die durch die WKID-Zeichenfolgenwerte referenzierten Datumstransformationsschritte werden in der umgekehrten Reihenfolge angewendet.(esri_coordsys_DatumTransformations_set
"6425" "3857"
(list
(list (cons "Direction" "Reverse") (cons "Step" 108355))
(list (cons "Direction" "Reverse") (cons "Step" 108282))
)
)
Ergebnis des Beispiels 2 für die Verwendung
Legt die kombinierte Datumstransformation in zwei Schritten in der aktuellen Zeichnung fest und gibt die gesamte Definition der Datumstransformation als Assoziationsliste zurück.
(("From" . "6425") ("To" . "3857") ("Transformation" ((("Direction" . "Reverse") ("Step" . "108355")) (("Direction" . "Reverse") ("Step" . "108282")))))Rückgabewerte
- Die Datumstransformation ist festgelegt und die gesamte Definition der Datumstransformation wird als Assoziationsliste zurückgegeben.
- Wenn bei der Funktion 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" . "Failed"))
Der eingegebene Wert für WKID oder WKT ist ungültig.
- (nil ("Error" . "This document contains existing web feature layers. Datum transformations cannot be modified when web feature layers present."))
Datumstransformationen können nicht festgelegt oder geändert werden, wenn die Zeichnung vorhandene Web-Feature-Layer enthält.
- (nil ("Error" . "Missing required argument."))
Mindestens eines der erforderlichen Argumente wurde nicht angegeben.