Entidades a JSON (Herramientas de conversión)

Resumen

Convierte entidades al formato JSON o GeoJSON de Esri. Los campos, la geometría y la referencia espacial de las entidades se convertirán a su correspondiente representación JSON y se escribirán en un archivo con una extensión .json o .geojson.

Uso

Puede habilitar el formato para que la representación JSON en el archivo de salida sea más legible. El archivo de salida se formateará con espacios, tabulaciones y retornos de carro para mejorar la legibilidad. Una notación JSON formateada puede ser beneficiosa para el desarrollo y pruebas de aplicaciones. Sin embargo, no se recomienda para aplicaciones de producción, ya que todos los espacios en blanco son innecesarios y omitidos por los analizadores de JSON. Además, la notación JSON formateada puede ser mucho mayor que su equivalente JSON y el tamaño del archivo será superior al de su correspondiente representación JSON. Puede afectar al rendimiento de las aplicaciones.
La conversión no admite uniones, relaciones ni asociaciones de las entidades.
Para convertir un subconjunto de entidades en una clase de entidad o una capa de entidades, use las herramientas [Seleccionar capa por atributo](../data-management/select-layer-by-attribute.yml) o Seleccionar capa por ubicación y seleccione el subconjunto de entidades que se van a convertir antes de utilizar De entidades a JSON.
Utilice el parámetro Salida a GeoJSON para crear un archivo .geojson conforme a la especificación GeoJSON. La especificación GeoJSON no admite la geometría de las curvas; las entidades de entrada que contengan curvas se densificarán durante la conversión.
Si la salida es un archivo .geojson, puede utilizar el parámetro Proyecto a WGS84 para proyectar las entidades de entrada en el sistema de coordenadas WGS84, que es el estándar de la especificación GeoJSON. Se aplicará una transformación geográfica predeterminada si es necesario. Si no se usa este parámetro, el archivo .geojson de salida contendrá una etiqueta crs que se puede utilizar en algunas aplicaciones para definir el sistema de coordenadas o el sistema de referencia de coordenadas. Esta etiqueta no es totalmente compatible con la especificación de GeoJSON.
La salida de la herramienta solo incluirá campos de atributos visibles de la entrada. Para incluir todos los campos, debe hacerlos todos visibles. Asimismo, puede usar el parámetro Usar alias de campos para utilizar los alias de los campos en la salida en lugar de los nombres de los campos.
El archivo de salida no puede tener más de 4 GB de tamaño. Reduzca los datos de entrada si son demasiado grandes.

Etiqueta	Explicación	Tipo de datos
Entidades de entrada	Entidades que se convertirán en formato JSON.	Feature Layer
JSON de salida	Archivo de salida `.json` o `.geojson`.	File
JSON con formato (Opcional)	Especifica si el archivo JSON se formateará para mejorar la legibilidad de forma similar al formato PJSON (Pretty JSON) de la especificación API REST de ArcGIS. Activado—Las entidades se formatearán según la especificación PJSON. Desactivado—Las entidades no se formatearán. Esta es la opción predeterminada.	Boolean
Incluir valores Z (Opcional)	Especifica si se incluirán los valores z de las entidades en el JSON. Activado—Los valores z se incluirán en las geometrías y la propiedad `hasZ` del JSON se establecerá en true. Desactivado—Los valores z no se incluirán en las geometrías y no se incluirá la propiedad `hasZ` del JSON. Esta es la opción predeterminada.	Boolean
Incluir valores M (Opcional)	Especifica si se incluirán los valores m de las entidades en el JSON. Activado—Los valores m se incluirán en las geometrías y la propiedad `hasM` del JSON se establecerá en true. Desactivado—Los valores m no se incluirán en las geometrías y no se incluirá la propiedad `hasM` del JSON. Esta es la opción predeterminada.	Boolean
Salida a GeoJSON (Opcional)	Especifica si la salida se creará en el formato GeoJSON, de acuerdo con la especificación de GeoJSON o en formato JSON de Esri. Activado—La salida se creará con el formato GeoJSON (archivo `.geojson`). Desactivado—La salida se creará en el formato JSON de Esri (archivo `.json`). Esta es la opción predeterminada.	Boolean
Proyecto a WGS84 (Opcional)	Especifica si las entidades de entrada se proyectarán al sistema de coordenadas geográficas WGS84 con una transformación geográfica predeterminada. Este parámetro solo se aplica cuando la salida es GeoJSON. Activado—Las entidades se proyectarán a WGS84. Desactivado—Las entidades no se proyectarán a WGS84. El GeoJSON contendrá una etiqueta CRS que define el sistema de coordenadas. Esta es la opción predeterminada.	Boolean
Usar alias de campos (Opcional)	Especifica si el archivo de salida utilizará los alias de los campos para los atributos de entidades. Activado—Los atributos de entidades de salida utilizarán los alias de los campos. Desactivado—Los atributos de entidad de salida no utilizarán los alias de campo; utilizarán los nombres de campo. Esta es la opción predeterminada.	Boolean

arcpy.conversion.FeaturesToJSON(in_features, out_json_file, {format_json}, {include_z_values}, {include_m_values}, {geoJSON}, {outputToWGS84}, {use_field_alias})

Nombre	Explicación	Tipo de datos
in_features	Entidades que se convertirán en formato JSON.	Feature Layer
out_json_file	Archivo de salida `.json` o `.geojson`.	File
format_json (Opcional)	Especifica si el archivo JSON se formateará para mejorar la legibilidad de forma similar al formato PJSON (Pretty JSON) de la especificación API REST de ArcGIS. `FORMATTED`—Las entidades se formatearán según la especificación PJSON. `NOT_FORMATTED`—Las entidades no se formatearán. Esta es la opción predeterminada.	Boolean
include_z_values (Opcional)	Especifica si se incluirán los valores z de las entidades en el JSON. `Z_VALUES`—Los valores z se incluirán en las geometrías y la propiedad `hasZ` del JSON se establecerá en true. `NO_Z_VALUES`—Los valores z no se incluirán en las geometrías y no se incluirá la propiedad `hasZ` del JSON. Esta es la opción predeterminada.	Boolean
include_m_values (Opcional)	Especifica si se incluirán los valores m de las entidades en el JSON. `M_VALUES`—Los valores m se incluirán en las geometrías y la propiedad `hasM` del JSON se establecerá en true. `NO_M_VALUES`—Los valores m no se incluirán en las geometrías y no se incluirá la propiedad `hasM` del JSON. Esta es la opción predeterminada.	Boolean
geoJSON (Opcional)	Especifica si la salida se creará en el formato GeoJSON, de acuerdo con la especificación de GeoJSON o en formato JSON de Esri. `GEOJSON`—La salida se creará con el formato GeoJSON (archivo `.geojson`). `NO_GEOJSON`—La salida se creará en el formato JSON de Esri (archivo `.json`). Esta es la opción predeterminada.	Boolean
outputToWGS84 (Opcional)	Especifica si las entidades de entrada se proyectarán al sistema de coordenadas geográficas WGS84 con una transformación geográfica predeterminada. Este parámetro solo se aplica cuando la salida es GeoJSON. `WGS84`—Las entidades se proyectarán a WGS84. `KEEP_INPUT_SR`—Las entidades no se proyectarán a WGS84. El GeoJSON contendrá una etiqueta CRS que define el sistema de coordenadas. Esta es la opción predeterminada.	Boolean
use_field_alias (Opcional)	Especifica si el archivo de salida utilizará los alias de los campos para los atributos de entidades. `USE_FIELD_ALIAS`—Los atributos de entidades de salida utilizarán los alias de los campos. `USE_FIELD_NAME`—Los atributos de entidad de salida no utilizarán los alias de campo; utilizarán los nombres de campo. Esta es la opción predeterminada.	Boolean

Muestra de código

Ejemplo 1 de FeaturesToJSON (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función FeaturesToJSON para crear archivos .json y .pjson.

import arcpy
import os

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

Ejemplo 2 de FeaturesToJSON (ventana de Python)

El siguiente script de la ventana de Python muestra cómo se usa la función FeaturesToJSON con valores z y m.

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

Ejemplo 3 de FeaturesToJSON (script independiente)

Convierta un subconjunto de entidades a JSON usando las funciones SelectLayerByLocation y SelectLayerByAttribute primero.

# Import system modules
import arcpy

# Set the workspace
arcpy.env.workspace = "c:/data/mexico.gdb"

# Make a layer from the feature class
arcpy.management.MakeFeatureLayer("cities", "cities_lyr")

# Select all cities that overlap the chihuahua polygon
arcpy.management.SelectLayerByLocation("cities_lyr", "intersect", "chihuahua",
                                       0, "new_selection")

# Within selected features, further select only those cities that have a
# population > 10,000
arcpy.management.SelectLayerByAttribute("cities_lyr", "SUBSET_SELECTION",
                                        '"population" > 10000')

# Convert the selected features to JSON
arcpy.conversion.FeaturesToJSON("cities_lyr", r"c:\data\myjsonfeatures.json")

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

Entidades a JSON (Herramientas de conversión)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados