Convertir la notation de coordonnées (Outils de gestion des données)

Résumé

Convertit des notations de coordonnées contenues dans un ou deux champs d’un format de notation à un autre.

En savoir plus sur les formats de notation pris en charge

Utilisation

Le système de coordonnées des valeurs stockées dans les valeurs X Field (Longitude) (Champ X (longitude)) et Y Field (Latitude) (Champ Y (latitude)) est spécifié via le paramètre Input Coordinate System (Système de coordonnées en entrée). Par défaut, il s’agit de GCS_WGS_1984. Si la table en entrée est une classe d’entités, le système de coordonnées des entités en entrée est utilisé par défaut.
Les formats suivants sont pris en charge :
- Degrés décimaux (DD)
- Degrés Minutes Décimales (DDM)
- Degrés Minutes Secondes (DMS)
- Global Area Reference System (GARS)
- World Geographic Reference System (GEOREF et GEOREF 16)
- Universal Transverse Mercator (UTM)
- United States National Grid (USNG et USNG 16)
- Military Grid Reference System (MGRS et MGRS 16)
Pour les options DD 1, DDM 1 et DMS 1 du paramètre Input Coordinate Format (Format de coordonnées en entrée), les valeurs de latitude et de longitude doivent représenter une localisation concaténée et stockée dans un champ unique.

Pour les options DD 2, DDM 2 et DMS 2, les valeurs de latitude et de longitude sont représentées par deux champs distincts.

Pour l’option DD numeric (DD numérique), les valeurs de latitude et de longitude sont stockées dans deux champs distincts de type double.

Pour les options Gars, Georef, Georef 16, UTM zones (Zones UTM), UTM bands (Bandes UTM), USNG, USNG 16, MGRS et MGRS 16, les valeurs sont des formats de coordonnées à chaîne unique, ce qui signifie que les coordonnées figurent dans un seul champ.
Pour les paramètres Input Coordinate Format (Format de coordonnées en entrée) et Output Coordinate Format (Format de coordonnées en sortie), les options MGRS 16 (par exemple, 11SLT7858811533670379), USNG 16 et Georef 16 ont une précision plus élevée (16 chiffres) que les options équivalentes MGRS (par exemple, 11SLT78588115), USNG et Georef (8 chiffres).
Tous les champs de la table en entrée, y compris le champ OID et les champs de format en entrée, sont transférés vers la classe d’entités ponctuelles en sortie. Les valeurs du champ OID permettent de différencier les notations valides converties si le paramètre Exclude records with invalid notation (Exclure les enregistrements avec une notation non valide) est activé.

Les noms de champ en sortie sont appariés au nom de la notation de coordonnées en sortie. Par exemple, si le format en sortie est MGRS, le nouveau nom de champ en sortie sera MGRS.

Si un champ portant le même nom que le champ en entrée existe déjà dans la sortie, le nom du champ copié se verra ajouter un numéro unique.
Désactivez le paramètre Exclude records with invalid notation (Exclure les enregistrements avec une notation non valide) pour conserver les informations concernant tous les enregistrements en entrée. L’outil Check Geometry (Vérifier les géométries) permet d’identifier les enregistrements comportant des notations non valides.

Si des enregistrements comportent des notations non valides, les messages envoyés par l’outil indiqueront le chemin d’accès au fichier journal contenant les ID de tous les enregistrements non valides.
The L’outil Add XY Coordinates (Ajouter des coordonnées XY) permet d’ajouter les deux champs POINT_X et POINT_Y à la classe d’entités ponctuelles en sortie. Ces champs contiennent les coordonnées d’un point dans l’unité du système de coordonnées de la classe d’entités.
L’outil peut convertir les notations numériques DD, DMS et DDM sous d’autres formats de sortie tant que les valeurs en entrée au format DD, DMS et DDM ne contiennent aucune lettre.

Etiqueter	Explication	Type de données
Input Table (Table en entrée)	Table en entrée ou fichier texte. Les entités ponctuelles sont également valides.	Table View
Classe d’entités en sortie	Classe d’entités ponctuelles en sortie. La table attributaire contiendra tous les champs de la table en entrée, ainsi que les champs contenant les valeurs converties dans le format en sortie.	Feature Class
Champ X (longitude)	Champ de la table en entrée qui contient la valeur de longitude. Pour les options DD 2, DD numeric (DD numérique), DDM 2 et DMS 2 du paramètre Input Coordinate Format (Format de coordonnées en entrée), il s’agit du champ de longitude. Pour les options DD 1, DDM 1 et DMS 1, ce champ contient les valeurs de latitude et de longitude dans une chaîne unique. Pour les options Gars, Georef, Georef 16, UTM zones (Zones UTM), UTM bands (Bandes UTM), USNG, USNG 16, MGRS et MGRS 16, ce champ contient une notation alphanumérique dans un champ de texte unique.	Field
Champ Y (latitude)	Champ de la table en entrée qui contient la valeur de latitude. Pour les options DD 2, DD numeric (DD numérique), DDM 2 et DMS 2 du paramètre Input Coordinate Format (Format de coordonnées en entrée), il s’agit du champ de latitude. Ce paramètre est inactif lorsque l’un des formats à chaîne unique est choisi.	Field
Format de coordonnées en entrée	Spécifie le format de coordonnées des champs en entrée. DD, DDM, DMS et UTM sont également des mots-clés valides. Ils peuvent être utilisés en les saisissant (dans la boîte de dialogue) ou en transmettant la valeur dans des scripts. Toutefois, les mots-clés avec un trait de soulignement et un qualificateur en disent plus sur les valeurs de champ. DD 1—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. DD 2—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. Ceci est le comportement par défaut. DDM 1—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. DDM 2—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. DMS 1—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. DMS 2—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. Gars—Le système mondial de référence de zone, qui repose sur la latitude et la longitude, divise et subdivise le monde en cellules. Georef—Le système mondial de référence géographique, basé sur une grille, divise le monde en quadrangles de 15 degrés et les subdivise en plus petits quadrangles. Georef 16—World Geographic Reference System avec une précision à 16 chiffres. Zones UTM—La lettre N ou S après le numéro de zone UTM désigne l’hémisphère nord ou sud. Bandes UTM—La lettre après le numéro de zone UTM désigne l’une des 20 bandes de latitude. N ou S ne désigne pas un hémisphère. USNG—Le format United States National Grid est presque identique à MGRS, mais il utilise le datum North American Datum 1983 (NAD83). USNG 16—United States National Grid avec une précision supérieure à 16 chiffres. MGRS—Le système de référence de carroyage militaire suit les coordonnées UTM et divise le monde en bandes de longitude de 6 degrés et en 20 bandes de latitude, mais MGRS subdivise également les zones de la grille en plus petites grilles de 100 000 mètres. Ces grilles de 100 000 mètres sont ensuite divisées en grilles de 10 000 mètres, de 1 000 mètres, de 100 mètres, de 10 mètres et de 1 mètre. MGRS 16—Military Grid Reference System avec une précision à 16 chiffres. Forme—Disponible uniquement lorsqu’une couche d’entités ponctuelles est sélectionnée en entrée. Les coordonnées de chaque point sont utilisées pour définir le format en sortie.	String
Format de coordonnées en sortie	Spécifie le format de coordonnées vers lequel les notations en entrée seront converties. DD, DDM, DMS et UTM sont également des mots-clés valides. Ils peuvent être utilisés en les saisissant (dans la boîte de dialogue) ou en transmettant la valeur dans des scripts. Toutefois, les mots-clés avec un trait de soulignement et un qualificateur en disent plus sur les valeurs de champ. DD 1—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. DD 2—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. DD numérique—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts de type double. Les valeurs Ouest et Sud sont indiquées par un signe moins. DDM 1—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. DDM 2—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. DMS 1—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. DMS 2—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. Gars—Le système mondial de référence de zone, qui repose sur la latitude et la longitude, divise et subdivise le monde en cellules. Georef—Le système mondial de référence géographique, basé sur une grille, divise le monde en quadrangles de 15 degrés et les subdivise en plus petits quadrangles. Georef 16—World Geographic Reference System avec une précision à 16 chiffres. Zones UTM—La lettre N ou S après le numéro de zone UTM désigne l’hémisphère nord ou sud. Bandes UTM—La lettre après le numéro de zone UTM désigne l’une des 20 bandes de latitude. N ou S ne désigne pas un hémisphère. USNG—Le format United States National Grid est presque identique à MGRS, mais il utilise le datum North American Datum 1983 (NAD83). USNG 16—United States National Grid avec une précision supérieure à 16 chiffres. MGRS—Le système de référence de carroyage militaire suit les coordonnées UTM et divise le monde en bandes de longitude de 6 degrés et en 20 bandes de latitude, mais MGRS subdivise également les zones de la grille en plus petites grilles de 100 000 mètres. Ces grilles de 100 000 mètres sont ensuite divisées en grilles de 10 000 mètres, de 1 000 mètres, de 100 mètres, de 10 mètres et de 1 mètre. MGRS 16—Military Grid Reference System avec une précision à 16 chiffres.	String
ID (Facultatif)	Ce paramètre n’est plus utilisé, car tous les champs sont transférés vers la table en sortie.	Field
Système de coordonnées en sortie (Facultatif)	Référence spatiale de la classe d’entités en sortie. La valeur par défaut est GCS_WGS_1984. L’outil projette la sortie sur la référence spatiale spécifiée. Si les systèmes de coordonnées en entrée et en sortie se trouvent dans un datum différent, une transformation par défaut sera utilisée en fonction des systèmes de coordonnées de l’entrée, de la sortie et de l’étendue des données.	Spatial Reference
Système de coordonnées en entrée (Facultatif)	Référence spatiale des données en entrée. Si la référence spatiale en entrée ne peut pas être obtenue à partir de la table en entrée, GCS_WGS_1984 sera utilisé par défaut.	Coordinate System
Exclure les enregistrements avec une notation non valide (Facultatif)	Indique si les enregistrements avec une notation non valide doivent être exclus. Activé—Les enregistrements non valides seront exclus et seuls les enregistrements valides seront convertis en points dans la sortie. Il s’agit de l’option par défaut. Décoché—Les enregistrements valides seront convertis en points dans la sortie et les enregistrements non valides seront inclus en tant que géométrie nulle.	Boolean

arcpy.management.ConvertCoordinateNotation(in_table, out_featureclass, x_field, y_field, input_coordinate_format, output_coordinate_format, {id_field}, {spatial_reference}, {in_coor_system}, {exclude_invalid_records})

Nom	Explication	Type de données
in_table	Table en entrée ou fichier texte. Les entités ponctuelles sont également valides.	Table View
out_featureclass	Classe d’entités ponctuelles en sortie. La table attributaire contiendra tous les champs de la table en entrée, ainsi que les champs contenant les valeurs converties dans le format en sortie.	Feature Class
x_field	Champ de la table en entrée qui contient la valeur de longitude. Pour les options `DD_2`, `DD_NUMERIC`, `DDM_2` et `DMS_2` du paramètre `input_coordinate_format`, il s’agit du champ de longitude. Pour les options `DD_1`, `DDM_1` et `DMS_1`, ce champ contient les valeurs de latitude et de longitude dans une chaîne unique. Pour les options `GARS`, `GEOREF`, `GEOREF16`, `UTM_ZONES`, `UTM_BANDS`, `USNG`, `USNG16`, `MGRS` et `MGRS16`, ce champ contient un système alphanumérique de notation dans un champ de texte unique.	Field
y_field	Champ de la table en entrée qui contient la valeur de latitude. Pour les options `DD_2`, `DD_NUMERIC`, `DDM_2` et `DMS_2` du paramètre `input_coordinate_format`, il s’agit du champ de longitude. Ce paramètre est ignoré lorsque l’un des formats à chaîne unique est choisi.	Field
input_coordinate_format	Spécifie le format de coordonnées des champs en entrée. DD, DDM, DMS et UTM sont également des mots-clés valides. Ils peuvent être utilisés en les saisissant (dans la boîte de dialogue) ou en transmettant la valeur dans des scripts. Toutefois, les mots-clés avec un trait de soulignement et un qualificateur en disent plus sur les valeurs de champ. `DD_1`—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. `DD_2`—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. Ceci est le comportement par défaut. `DDM_1`—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. `DDM_2`—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. `DMS_1`—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. `DMS_2`—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. `GARS`—Le système mondial de référence de zone, qui repose sur la latitude et la longitude, divise et subdivise le monde en cellules. `GEOREF`—Le système mondial de référence géographique, basé sur une grille, divise le monde en quadrangles de 15 degrés et les subdivise en plus petits quadrangles. `GEOREF16`—World Geographic Reference System avec une précision à 16 chiffres. `UTM_ZONES`—La lettre N ou S après le numéro de zone UTM désigne l’hémisphère nord ou sud. `UTM_BANDS`—La lettre après le numéro de zone UTM désigne l’une des 20 bandes de latitude. N ou S ne désigne pas un hémisphère. `USNG`—Le format United States National Grid est presque identique à MGRS, mais il utilise le datum North American Datum 1983 (NAD83). `USNG16`—United States National Grid avec une précision supérieure à 16 chiffres. `MGRS`—Le système de référence de carroyage militaire suit les coordonnées UTM et divise le monde en bandes de longitude de 6 degrés et en 20 bandes de latitude, mais MGRS subdivise également les zones de la grille en plus petites grilles de 100 000 mètres. Ces grilles de 100 000 mètres sont ensuite divisées en grilles de 10 000 mètres, de 1 000 mètres, de 100 mètres, de 10 mètres et de 1 mètre. `MGRS16`—Military Grid Reference System avec une précision à 16 chiffres. `SHAPE`—Disponible uniquement lorsqu’une couche d’entités ponctuelles est sélectionnée en entrée. Les coordonnées de chaque point sont utilisées pour définir le format en sortie.	String
output_coordinate_format	Spécifie le format de coordonnées vers lequel les notations en entrée seront converties. DD, DDM, DMS et UTM sont également des mots-clés valides. Ils peuvent être utilisés en les saisissant (dans la boîte de dialogue) ou en transmettant la valeur dans des scripts. Toutefois, les mots-clés avec un trait de soulignement et un qualificateur en disent plus sur les valeurs de champ. `DD_1`—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. `DD_2`—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. `DD_NUMERIC`—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts de type double. Les valeurs Ouest et Sud sont indiquées par un signe moins. `DDM_1`—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. `DDM_2`—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. `DMS_1`—Les valeurs de longitude et de latitude se trouvent dans un seul champ. Les deux valeurs sont séparées par un espace, une virgule ou une barre oblique. `DMS_2`—Les valeurs de longitude et de latitude se trouvent dans deux champs distincts. `GARS`—Le système mondial de référence de zone, qui repose sur la latitude et la longitude, divise et subdivise le monde en cellules. `GEOREF`—Le système mondial de référence géographique, basé sur une grille, divise le monde en quadrangles de 15 degrés et les subdivise en plus petits quadrangles. `GEOREF16`—World Geographic Reference System avec une précision à 16 chiffres. `UTM_ZONES`—La lettre N ou S après le numéro de zone UTM désigne l’hémisphère nord ou sud. `UTM_BANDS`—La lettre après le numéro de zone UTM désigne l’une des 20 bandes de latitude. N ou S ne désigne pas un hémisphère. `USNG`—Le format United States National Grid est presque identique à MGRS, mais il utilise le datum North American Datum 1983 (NAD83). `USNG16`—United States National Grid avec une précision supérieure à 16 chiffres. `MGRS`—Le système de référence de carroyage militaire suit les coordonnées UTM et divise le monde en bandes de longitude de 6 degrés et en 20 bandes de latitude, mais MGRS subdivise également les zones de la grille en plus petites grilles de 100 000 mètres. Ces grilles de 100 000 mètres sont ensuite divisées en grilles de 10 000 mètres, de 1 000 mètres, de 100 mètres, de 10 mètres et de 1 mètre. `MGRS16`—Military Grid Reference System avec une précision à 16 chiffres.	String
id_field (Facultatif)	Ce paramètre est ignoré, car tous les champs sont transférés vers la table en sortie.	Field
spatial_reference (Facultatif)	Référence spatiale de la classe d’entités en sortie. La valeur par défaut est GCS_WGS_1984. L’outil projette la sortie sur la référence spatiale spécifiée. Si les systèmes de coordonnées en entrée et en sortie se trouvent dans un datum différent, une transformation par défaut sera utilisée en fonction des systèmes de coordonnées de l’entrée, de la sortie et de l’étendue des données.	Spatial Reference
in_coor_system (Facultatif)	Référence spatiale des données en entrée. Si la référence spatiale en entrée ne peut pas être obtenue à partir de la table en entrée, GCS_WGS_1984 sera utilisé par défaut.	Coordinate System
exclude_invalid_records (Facultatif)	Indique si les enregistrements avec une notation non valide doivent être exclus. `EXCLUDE_INVALID`—Les enregistrements non valides seront exclus et seuls les enregistrements valides seront convertis en points dans la sortie. Il s’agit de l’option par défaut. `INCLUDE_INVALID`—Les enregistrements valides seront convertis en points dans la sortie et les enregistrements non valides seront inclus en tant que géométrie nulle.	Boolean

Exemple de code

Exemple 1 d’utilisation de l’outil ConvertCoordinateNotation (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction ConvertCoordinateNotation avec un champ de format en entrée.

# import arcpy module
import arcpy

# set locals variables
in_tab = r"c:\data\notation.gdb\loc_mgrs"
out_pts = r"c:\data\notation.gdb\loc_final"

# call Convert Coordinate Notation with MGRS as input field.
# leaving out spatial reference parameter will default to WGS 1984
arcpy.management.ConvertCoordinateNotation(in_tab, out_pts, "m10d", "#", "MGRS", "DD_1")

Exemple 2 d’utilisation de l’outil ConvertCoordinateNotation (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction ConvertCoordinateNotation avec deux champs de format en entrée.

# imports
import arcpy

arcpy.env.workspace = r"c:\data\mtf.gdb"

# set parameter values
input_table = 'rit_up_DD'
output_points = 'ritLOC'
x_field = 'LON'
y_field = 'LAT'
input_format = 'DD_2'
output_format = 'GARS'
id_field = 'CITY_NAME'
spatial_ref = arcpy.SpatialReference('WGS 1984')

try:
    arcpy.management.ConvertCoordinateNotation(input_table, output_points, x_field, y_field,
                                               input_format, output_format, id_field, spatial_ref)
    print(arcpy.GetMessages(0))

except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))

except Exception as ex:
    print(ex.args[0])

Exemple 3 d’utilisation de l’outil ConvertCoordinateNotation (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction ConvertCoordinateNotation avec les formats UTM_ZONES et UTM_BANDS.

# imports
import arcpy

arcpy.env.workspace = r"c:\data\ccn.gdb"

# export_utm58 table contains coordinates in UTM_BANDS format
# where N and S indicate latitude bands,
# for example, 58S4144921393176 - here 58S is latitude band
input_table = 'export_utm58'

# the coordinate values in output point table will be in UTM_ZONES format
# for example, 58N4144921393176 - note that it is now 58N because
# the point is in UTM 58 North zone
output_points = 'utm_zone18'

spatial_ref = arcpy.SpatialReference('WGS 1984')

try:
    arcpy.management.ConvertCoordinateNotation(input_table, output_points, "LOCS", "",
                                               "UTM_BANDS", "UTM_ZONES", "", spatial_ref)
    print(arcpy.GetMessages(0))

except Exception as ex:
    print(ex.args[0])

Exemple 4 d’utilisation de l’outil ConvertCoordinateNotation (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction ConvertCoordinateNotation pour convertir en valeurs à virgule flottante les valeurs textuelles en sortie exprimées en degrés décimaux. Un signe moins est utilisé à la place des lettres S et O.

# imports
import arcpy

# output from Convert Coordinate Notation tool
# for DD_2 (and also for DD_1) format, the output values are in string format
# for example, for DD_1, the output values may be '43.63872N 116.24135W'
in_table = r"c:\data\ccn.gdb\ccn_dd1"

# add a field of type DOUBLE to store the numeric longitude value
arcpy.management.AddField(in_table, "DDLonDbl", "DOUBLE")

# now call CalculateField tool to convert the values, 'W' is negative
expr = """def convertToDouble(fldval):
    val = float(fldval[:-1])
    if fldval[-1:] == 'W':
        return val * -1.0
    else:
        return val"""
try:
    # DDLon field contains longitudes in a string field
    arcpy.management.CalculateField(in_table, "DDLonDbl",  "convertToDouble(!DDLon!)", "PYTHON_9.3", expr)
except:
    print(arcpy.GetMessages())

# add another field to store the numeric longitude value
arcpy.management.AddField(in_table, "DDLatDbl", "DOUBLE")

# call CalculateField again to convert the values, 'S' is negative
expr = """def convertToDouble(fldval):
    val = float(fldval[:-1])
    if fldval[-1:] == 'S':
        return val * -1.0
    else:
        return val"""

try:
    # DDLat field contains latitudes in a string field
    arcpy.management.CalculateField(in_table, "DDLatDbl", "convertToDouble(!DDLat!)", "PYTHON_9.3", expr)
except:
    print(arcpy.GetMessages())

Environnements

Espace de travail temporaire, Espace de travail courant, Système de coordonnées en sortie, Transformations géographiques, Tolérance XY

Informations de licence