JSON vers entités (Outils de conversion)

Résumé

Convertit des collections d’entités dans un fichier de format Esri JSON (.json) ou GeoJSON (.geojson) en classe d’entités.

Utilisation

Si la propriété hasZ ou hasM du fichier .json en entrée est définie sur True, des valeurs z et m sont attribuées aux entités en sortie.
Si l’entrée est un fichier .geojson, vous devez sélectionner le type de géométrie à convertir en classe d’entités. GeoJSON prend en charge plusieurs types d’entités au sein du même fichier. Une classe d’entités doit se composer d’entités du même type.
Les champs de texte de la sortie sont très longs (2 milliards de caractères) car les spécifications de format JSON et GeoJSON n’incluent pas de propriété de longueur pour les attributs de texte. Dans un souci d’optimisation des performances de conversion, une longueur fixe importante est utilisée ce qui permet d’éviter de lire toutes les valeurs pour déterminer le plus grand nombre de caractères.
Les spécifications de format JSON et GeoJSON n’incluent pas de méthode standard de stockage des valeurs datetime. Une valeur datetime peut être représentée sous forme de valeur entière de secondes depuis l’heure Unix epoch. Pour convertir ce nombre en une valeur datetime, utilisez l’outil Calculate Field (Calculer un champ) ou une expression Python, telle que datetime.datetime.fromtimestamp(!date_field!).
Si l’entrée est un fichier .geojson, les attributs du premier enregistrement permettent de définir la structure de la classe d’entités en sortie.

Etiqueter Explication Type de données

Etiqueter	Explication	Type de données
Fichier JSON ou GeoJSON en entrée	Fichier `.json` ou `.geojson` en entrée qui est converti en classe d’entités. L’extension du fichier en entrée détermine le format utilisé par l’outil pour une conversion correcte. Dans le cas d’un fichier au format JSON Esri, utilisez l’extension `.json` ; dans le cas de fichiers au format GeoJSON, utilisez l’extension `.geojson`.	File
Classe d’entités en sortie	Classe d’entités en sortie qui contient les entités du fichier `.json` ou `.geojson` en entrée.	Feature Class
Type de géométrie (Facultatif)	Indique le type de géométrie qui servira pour la conversion du format GeoJSON en entités. Ce paramètre n’est utilisé que si l’entrée est un fichier `.geojson`. Si le fichier `.geojson` ne contient aucun des types de géométrie spécifiés, la classe d’entités en sortie est vide. Point—Les points seront convertis en entités. Multi-point—Les multi-points seront convertis en entités. Polyligne—Les polylignes seront converties en entités. Polygone—Les polygones seront convertis en entités.	String

Fichier JSON ou GeoJSON en entrée

Fichier .json ou .geojson en entrée qui est converti en classe d’entités.

L’extension du fichier en entrée détermine le format utilisé par l’outil pour une conversion correcte. Dans le cas d’un fichier au format JSON Esri, utilisez l’extension .json ; dans le cas de fichiers au format GeoJSON, utilisez l’extension .geojson.

File

Classe d’entités en sortie

Classe d’entités en sortie qui contient les entités du fichier .json ou .geojson en entrée.

Feature Class

Type de géométrie

(Facultatif)

Indique le type de géométrie qui servira pour la conversion du format GeoJSON en entités. Ce paramètre n’est utilisé que si l’entrée est un fichier .geojson. Si le fichier .geojson ne contient aucun des types de géométrie spécifiés, la classe d’entités en sortie est vide.

Point—Les points seront convertis en entités.
Multi-point—Les multi-points seront convertis en entités.
Polyligne—Les polylignes seront converties en entités.
Polygone—Les polygones seront convertis en entités.

String

arcpy.conversion.JSONToFeatures(in_json_file, out_features, {geometry_type})

Nom Explication Type de données

Nom	Explication	Type de données
in_json_file	Fichier `.json` ou `.geojson` en entrée qui est converti en classe d’entités. L’extension du fichier en entrée détermine le format utilisé par l’outil pour une conversion correcte. Dans le cas d’un fichier au format JSON Esri, utilisez l’extension `.json` ; dans le cas de fichiers au format GeoJSON, utilisez l’extension `.geojson`.	File
out_features	Classe d’entités en sortie qui contient les entités du fichier `.json` ou `.geojson` en entrée.	Feature Class
geometry_type (Facultatif)	Indique le type de géométrie qui servira pour la conversion du format GeoJSON en entités. Ce paramètre n’est utilisé que si l’entrée est un fichier `.geojson`. Si le fichier `.geojson` ne contient aucun des types de géométrie spécifiés, la classe d’entités en sortie est vide. `POINT`—Les points seront convertis en entités. `MULTIPOINT`—Les multi-points seront convertis en entités. `POLYLINE`—Les polylignes seront converties en entités. `POLYGON`—Les polygones seront convertis en entités.	String

in_json_file

Fichier .json ou .geojson en entrée qui est converti en classe d’entités.

File

out_features

Classe d’entités en sortie qui contient les entités du fichier .json ou .geojson en entrée.

Feature Class

geometry_type

(Facultatif)

POINT—Les points seront convertis en entités.
MULTIPOINT—Les multi-points seront convertis en entités.
POLYLINE—Les polylignes seront converties en entités.
POLYGON—Les polygones seront convertis en entités.

String

Exemple de code

Exemple d’utilisation de l’outil JSONToFeatures (fenêtre Python)

Le script Python ci-dessous illustre l’utilisation de la fonction JSONToFeatures.

import arcpy
import os
arcpy.env.workspace = "c:/data"
arcpy.conversion.JSONToFeatures("myjsonfeatures.json", os.path.join("outgdb.gdb", "myfeatures"))

Environnements

Espace de travail courant, Espace de travail temporaire

Informations de licence