Die Funktion esri_coordsys_DatumTransformation_set legt eine Datumstransformation in der aktuellen Zeichnung fest. Wenn die Datumstransformation (die Ausgangs- und Zielkoordinatensysteme) bereits vorhanden ist, wird sie überschrieben. Die Funktion gibt die festgelegte Datumstransformation zurück.
Syntax
(esri_coordsys_DatumTransformation_set FromCS ToCS transformationStep_properties)
Argumente
- FromCS | Zeichenfolge | Erforderlich | Die gültige Well-known ID (WKID) oder der Well-Known Text (WKT) des Esri Koordinatensystems als Zeichenfolge.
- ToCS | Zeichenfolge | Erforderlich | Die gültige Well-known ID (WKID) oder der Well-Known Text (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, entweder "Forward" oder "Reverse", je nachdem, in welche Richtung der Transformationsschritt angewendet werden soll.
Erforderlich
"Step"
Zeichenfolge
Die WKID oder der WKT des Transformationsschritts.
Erforderlich
Verwendung
Beim Erstellen einer kombinierten Datumstransformation muss die Reihenfolge der einzelnen Schritte korrekt sein. Im Beispiel 2 für die Verwendung ist zum Beispiel 108355 der erste Schritt und 108282 der zweite und letzte Schritt. Die Richtung muss in Form einer Zeichenfolge "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 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
Festlegen einer Datumstransformation in einem einzelnen Schritt in der aktuellen Zeichnung zwischen den durch eine WKID angegebenen Ausgangs- und Ziel-Koordinatensystemen. Die Liste der Schritte enthält einen einzelnen Datumstransformationsschritt, der eine WKID referenziert und in der Vorwärtsreihenfolge angewendet werden muss.(esri_coordsys_DatumTransformation_set
"2882" "3857"
(list
(list (cons "Direction" "Forward") (cons "Step" 1580))
)
)
Ergebnis des Beispiels 1 für die Verwendung
Die Datumstransformation in einem Schritt wird in der aktuellen Zeichnung festgelegt, und die gesamte Definition der Datumstransformation wird als Assoziationsliste zurückgegeben.
(("From" . "2882") ("To" . "3857") ("Transformation" ((("Direction" . "Forward") ("Step" . "1580")))))Beispiel 2 für die Verwendung
Festlegen einer kombinierten Datumstransformation in der aktuellen Zeichnung zwischen den durch eine WKID angegebenen Ausgangs- und Ziel-Koordinatensystemen. Die durch die WKID-Zeichenfolgenwerte referenzierten Datumstransformationsschritte werden in der umgekehrten Reihenfolge angewendet.(esri_coordsys_DatumTransformation_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
Die kombinierte Datumstransformation in zwei Schritten wird in der aktuellen Zeichnung festgelegt, und die gesamte Definition der Datumstransformation wird als Assoziationsliste zurückgegeben.
(("From" . "6425") ("To" . "3857") ("Transformation" ((("Direction" . "Reverse") ("Step" . "108355")) (("Direction" . "Reverse") ("Step" . "108282")))))Rückgabewerte
Folgende Werte sind mögliche Rückgabewerte:
- Bei erfolgreicher Ausführung wird die Datumstransformation festgelegt und die gesamte Definition der Datumstransformation wird als Assoziationsliste zurückgegeben.
- 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" . "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.