Geocodificar direcciones (Herramientas de geocodificación)

Resumen

Geocodifica una tabla de direcciones. Este proceso requiere una tabla que almacene las direcciones que desea geocodificar y un localizador de direcciones o un localizador de direcciones compuesto. Esta herramienta geocodifica las direcciones almacenadas en el localizador y guarda el resultado de cada registro de entrada en una nueva clase de entidad de punto. Al usar ArcGIS World Geocoding Service, esta operación puede consumir créditos.

Para realizar operaciones de geocodificación con ArcGIS World Geocoding Service, es necesario disponer de una cuenta de organización de ArcGIS, y se consumen créditos. La cuenta de organización debe tener suficientes créditos para completar toda la solicitud de geocodificación.

Nota:

La estimación de créditos está disponible en la parte superior de la herramienta cuando el portal activo es ArcGIS Online y el localizador de entrada es ArcGIS World Geocoding Service.

Uso

Puede geocodificar direcciones almacenadas en un único campo, divididas en varios campos, o almacenadas en un solo campo y un campo de país. Un único campo de entrada almacena la dirección completa; por ejemplo, 303 Peachtree St NE, Atlanta GA 30308. Se admiten varios campos si las direcciones de entrada están divididas en varios campos, como Address, City, State y ZIP para una dirección general de Estados Unidos. Un único campo de entrada que almacene la dirección completa, por ejemplo: 303 Peachtree St NE, Atlanta GA 30308, y un campo que almacene el país asociado con la dirección, por ejemplo: EE. UU también se admite.
Algunos localizadores admiten varios campos de dirección de entrada tales como Address, Address2 y Address3. En este caso, el componente de dirección se puede separar en varios campos y los campos de dirección se concatenarán en el momento de la geocodificación. Por ejemplo, 100, Main st y Apt 140 en tres campos, o 100 Main st y Apt 140 en dos campos, ambos se convertirían en 100 Main st Apt 140 al geocodificar.
La clase de entidad de salida se guarda en la misma referencia espacial que el localizador de direcciones. Para cambiar la referencia espacial de la clase de entidad de salida, establezca un sistema de coordenadas de salida diferente en la configuración del entorno de la herramienta.
La clase de entidad de salida, por defecto, almacena una copia de la dirección de entrada e información adicional, por ejemplo, puntuación, estado y dirección coincidente de cada registro. Las direcciones se pueden volver a concordar utilizando la herramienta Volver a hacer concordar direcciones o la opción Volver a hacer concordar direcciones que abre el panel Volver a hacer concordar direcciones. Editar las direcciones en la tabla de direcciones de entrada no cambiará el resultado en la clase de entidad de salida una vez que termina el proceso de concordancia y se crea la clase de entidad.

Más información sobre los resultados de repetir geocodificación
Se requiere una suscripción a ArcGIS Online para organizaciones para geocodificar una tabla de direcciones usando ArcGIS World Geocoding Service.
No se admiten los parámetros siguientes para todos los localizadores utilizados para el valor del parámetro Localizador de direcciones de entrada: País o región, Tipo de ubicación preferida y Categoría.
Para generar la sintaxis de Python correcta, ejecute primero la herramienta desde el panel Geoprocesamiento con las opciones de parámetros apropiadas. A continuación, abra el menú Ejecutar y elija la opción Copiar comando de Python.
Al geocodificar una tabla de direcciones o ubicaciones con un localizador sensible a valores z, utilice esta herramienta en una escena local. Los resultados de geocodificación sensible a valores z se agregarán automáticamente a la escena local con las propiedades de elevación establecidas en la opción En altura absoluta ![] (../../icons/ElevationAbsoluteHeight16.png).

Si la escena local contiene la superficie de elevación que se utilizó para digitalizar los datos de referencia de puntos que se utilizaron para construir el localizador, establezca las propiedades de elevación de los resultados de la geocodificación en la opción En altura absoluta ![] (../../icons/ElevationAbsoluteHeight16.png). Se puede hacer en el cuadro de diálogo Propiedades de capa en la pestaña Elevación. Si la superficie de elevación utilizada para crear los datos de referencia no se encuentra en la escena local, establezca la elevación de los resultados de la geocodificación en la opción En relación con el suelo ![] (../../icons/ElevationRelativeToGround16.png).

Más información sobre la definición de las características de altura de las capas

Etiqueta	Explicación	Tipo de datos
Tabla de entrada	La tabla de direcciones que se geocodificará.	Table View
Localizador de direcciones de entrada	El localizador de direcciones que se utilizará para geocodificar la tabla de direcciones. Nota: Incluir la extensión `.loc` después del nombre del localizador al final de la ruta del localizador es opcional.	Address Locator
Campos de dirección de entrada	La representación cartográfica de los campos de dirección que utilizó el localizador de direcciones para los campos en la tabla de direcciones de entrada. Especifique Un solo campo si la dirección completa se almacena en un solo campo de la tabla de entrada, por ejemplo, 303 Peachtree St NE, Atlanta, GA 30308. Especifique Varios campos si las direcciones de entrada están divididas en varios campos como `Address`, `City`, `State` y `ZIP` para una dirección genérica de Estados Unidos. Especifique Un solo campo y Campo de país si la dirección completa y el país están divididos en campos separados, como `Address` (303 Peachtree St NE, Atlanta, GA 30308) y `Country` (USA). Algunos localizadores admiten varios campos de direcciones de entrada tales como `Address`, `Address2` y `Address3`. En este caso, el componente de dirección se puede separar en varios campos y los campos de dirección se concatenarán en el momento de la geocodificación. Por ejemplo, 100, Main st y Apt 140 en tres campos, o 100 Main st y Apt 140 en dos campos, ambos se convertirían en 100 Main st Apt 140 al geocodificar. Si no asigna un campo de dirección de entrada opcional empleado por el localizador de direcciones a un campo de la tabla de entrada de direcciones, especifique que no hay ninguna asignación con <None> en lugar del nombre de campo.	Field Info
Clase de entidad de salida	La clase de entidad geocodificada de salida. Nota: No se admite guardar la salida en formato shapefile debido a las limitaciones del shapefile.	Feature Class
Clase de entidad de salida dinámica (Opcional)	Heredado: Este parámetro no tiene ningún efecto en ArcGIS Pro. Se conserva para compatibilidad con las versiones anteriores de ArcGIS Desktop. En ArcGIS Pro, el único valor que se acepta es `STATIC`. Activado—Esta opción no es aplicable en ArcGIS Pro. Consulte la ayuda de ArcGIS Desktop para esta herramienta. Desactivado—Se creará una copia estática de la tabla de direcciones de entrada de campos en la clase de entidad de salida. Este es el único valor permitido.	Boolean
País o región (Opcional)	País o países a los que se limitará la búsqueda en lo que respecta a las direcciones de geocodificación. Especificar un país mejorará la precisión de la geocodificación en la mayoría de los casos. Cuando no se especifica ningún país, la geocodificación se realiza utilizando todos los países compatibles del localizador. El valor de este parámetro se invalidará cuando especifique Campo único y campo de país en el parámetro Campos de dirección de entrada.	String
Tipo de ubicación preferida (Opcional)	Especifica la geometría de salida preferida que se devolverá para las coincidencias de `PointAddress`. Si la ubicación deseada no existe en los datos, se devolverá la ubicación predeterminada de Ubicación de la dirección. Consulte la página web de Ayuda de ArcGIS REST API para obtener más información sobre el parámetro `locationType` para `geocodeAddresses`. Ubicación de dirección—Se devolverá la geometría para los resultados de geocodificación que representan una ubicación de dirección, por ejemplo, una ubicación de cubierta, un centroide de parcela o una entrada principal. Esta es la opción predeterminada. Ubicación de generación de rutas—Se devolverá la geometría para los resultados de geocodificación que representan una ubicación cercana al lado de la calle, que se puede utilizar para la generación de rutas para vehículos.	String
Categoría (Opcional)	Limita los tipos de lugares que busca el localizador, lo que elimina las coincidencias de falsos positivos y las coincidencias de nivel de dirección no deseadas, o reduce la incertidumbre de las búsquedas de coordenadas. Este parámetro puede ayudar a acelerar el proceso de búsqueda. Cuando no se utiliza ninguna categoría, la geocodificación se realiza utilizando todas las categorías compatibles. No todos los valores de categoría son compatibles con todas las ubicaciones y países. Consulte la página web de Ayuda de ArcGIS REST API para obtener más información sobre el filtrado por categoría.	String
Campos de salida (Opcional)	Especifica los campos de salida del localizador que se devolverán en los resultados de geocodificación. Los nombres de campo originales del valor del parámetro Tabla de entrada se mantendrán si se especifica la opción Solo ubicación, Mínimo o Campos de usuario y mínimo. Nota: Este parámetro se puede utilizar con localizadores de entrada creados con las herramientas Crear localizador o Crear localizador de entidades almacenados en el disco o publicados en Enterprise 10.9 o posterior. Los localizadores compuestos que contienen al menos un localizador creado con la herramienta Crear localizador de direcciones no admiten este parámetro. Todo—Incluye todos los campos de salida del localizador disponibles en los resultados de geocodificación. Esta es la opción predeterminada. Solo ubicación—Almacena el campo `Shape` en los resultados de geocodificación. Mínima—Agrega los siguientes campos que describen la ubicación y el grado de coincidencia de la información del localizador en los resultados de geocodificación: `Shape`, `Status`, `Score`, `Match_type`, `Match_addr` y `Addr_type`. Campos de usuario y mínimo—Los campos `MINIMAL`, así como cualquier campo de salida personalizado definido por el usuario, se agregarán y se devolverán en los resultados de geocodificación.	String
Narrativa de coincidencia (Opcional)	Especifica cómo se devolverá la narrativa de coincidencia en la clase de entidad geocodificada de salida. Si no se especifica ningún valor de parámetro, se utilizará la configuración de la propiedad de localizador Incluir narración de coincidencia. Este parámetro puede ayudar a comprender mejor cómo se hicieron coincidir las direcciones en la clase de entidad geocodificada. Consulte la página web de Ayuda de ArcGIS REST API para obtener más información sobre el parámetro returnMatchNarrative para geocodeAddresses. Agregar narrativa de coincidencia a la salida—Se agregará un campo denominado `MatchNarrative` a la clase de entidad geocodificada. Este campo contiene el texto narrativo de la coincidencia para cada dirección coincidente. Dividir la narrativa de coincidencia en campos—El texto narrativo de coincidencia de un solo campo se extraerá del objeto JSON. El texto narrativo de la coincidencia se analizará, se dividirá en campos individuales y se agregará a la clase de entidad geocodificada.	String

arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type}, {category}, {output_fields}, {match_narrative})

Nombre	Explicación	Tipo de datos
in_table	La tabla de direcciones que se geocodificará.	Table View
address_locator	El localizador de direcciones que se utilizará para geocodificar la tabla de direcciones. Nota: Incluir la extensión `.loc` después del nombre del localizador al final de la ruta del localizador es opcional.	Address Locator
in_address_fields [[input_address_field, table_field_name],...]	Cada asignación de campos en este parámetro está en el formato `input_address_field, table_field_name`, donde `input_address_field` es el nombre del campo de dirección de entrada especificado por el localizador y `table_field_name` es el nombre del campo correspondiente en la tabla de direcciones que se desea geocodificar. Puede especificar un único campo de entrada que almacene la dirección completa; por ejemplo, 303 Peachtree St NE, Atlanta GA 30308. Otra alternativa es especificar varios campos si las direcciones de entrada están divididas en diferentes campos, como `Address`, `City`, `State` y `ZIP` para una dirección general de Estados Unidos. También puede especificar un único campo de entrada que almacene la dirección completa, por ejemplo, 303 Peachtree St NE, Atlanta, GA 30308, y un campo que almacene el país asociado a la dirección, por ejemplo, EE. UU. Algunos localizadores admiten múltiples campos de dirección de entrada, por ejemplo, `Address`, `Address2`, y `Address3`. En este caso, el componente de dirección se puede separar en varios campos y los campos de dirección se concatenarán en el momento de la geocodificación. Por ejemplo, 100, Main st y Apt 140 en tres campos, o 100 Main st y Apt 140 en dos campos, ambos se convertirían en 100 Main st Apt 140 al geocodificar. Si no asigna un campo de dirección de entrada opcional empleado por el localizador de direcciones a un campo de la tabla de entrada de direcciones, especifique que no hay ninguna asignación con `<None>` en lugar del nombre de campo.	Field Info
out_feature_class	La clase de entidad geocodificada de salida. Nota: No se admite guardar la salida en formato shapefile debido a las limitaciones del shapefile.	Feature Class
out_relationship_type (Opcional)	Heredado: Este parámetro no tiene ningún efecto en ArcGIS Pro. Se conserva para compatibilidad con las versiones anteriores de ArcGIS Desktop. En ArcGIS Pro, el único valor que se acepta es `STATIC`. `DYNAMIC`—Esta opción no es aplicable en ArcGIS Pro. Consulte la ayuda de ArcGIS Desktop para esta herramienta. `STATIC`—Se creará una copia estática de la tabla de direcciones de entrada de campos en la clase de entidad de salida. Este es el único valor permitido.	Boolean
country [country,...] (Opcional)	País o países a los que se limitará la búsqueda en lo que respecta a las direcciones de geocodificación. Especificar un país mejorará la precisión de la geocodificación en la mayoría de los casos. Cuando no se especifica ningún país, la geocodificación se realiza utilizando todos los países compatibles del localizador. El valor de este parámetro se invalidará cuando especifique `in_table` Campo único y campo de país `Country` en el parámetro `in_address_fields` Asignación de campos de dirección. Especifique el valor como códigos de país de dos o tres caracteres en una lista separada por comas. Consulte la columna Códigos de país admitidos para ver el valor de entrada que se debe utilizar.	String
location_type (Opcional)	Especifica la geometría de salida preferida que se devolverá para las coincidencias de `PointAddress`. Si la ubicación deseada no existe en los datos, se devolverá la ubicación predeterminada de `ADDRESS_LOCATION`. Consulte la página web de Ayuda de ArcGIS REST API para obtener más información sobre el parámetro `locationType` para `geocodeAddresses`. `ADDRESS_LOCATION`—Se devolverá la geometría para los resultados de geocodificación que representan una ubicación de dirección, por ejemplo, una ubicación de cubierta, un centroide de parcela o una entrada principal. Esta es la opción predeterminada. `ROUTING_LOCATION`—Se devolverá la geometría para los resultados de geocodificación que representan una ubicación cercana al lado de la calle, que se puede utilizar para la generación de rutas para vehículos.	String
category [category,...] (Opcional)	Limita los tipos de lugares que busca el localizador, lo que elimina las coincidencias de falsos positivos y las coincidencias de nivel de dirección no deseadas, o reduce la incertidumbre de las búsquedas de coordenadas. Este parámetro puede ayudar a acelerar el proceso de búsqueda. Cuando no se utiliza ninguna categoría, la geocodificación se realiza utilizando todas las categorías compatibles. No todos los valores de categoría son compatibles con todas las ubicaciones y países. Consulte la página web de Ayuda de ArcGIS REST API para obtener más información sobre el filtrado por categoría.	String
output_fields (Opcional)	Especifica los campos de salida del localizador que se devolverán en los resultados de geocodificación. Los nombres de campo originales del valor del parámetro `in_table` se mantendrán si se especifica la opción `LOCATION_ONLY`, `MINIMAL` o `MINIMAL_AND_USER`. Nota: Este parámetro se puede utilizar con localizadores de entrada creados con las herramientas Crear localizador o Crear localizador de entidades almacenados en el disco o publicados en Enterprise 10.9 o posterior. Los localizadores compuestos que contienen al menos un localizador creado con la herramienta Crear localizador de direcciones no admiten este parámetro. `ALL`—Incluye todos los campos de salida del localizador disponibles en los resultados de geocodificación. Esta es la opción predeterminada. `LOCATION_ONLY`—Almacena el campo `Shape` en los resultados de geocodificación. `MINIMAL`—Agrega los siguientes campos que describen la ubicación y el grado de coincidencia de la información del localizador en los resultados de geocodificación: `Shape`, `Status`, `Score`, `Match_type`, `Match_addr` y `Addr_type`. `MINIMAL_AND_USER`—Los campos `MINIMAL`, así como cualquier campo de salida personalizado definido por el usuario, se agregarán y se devolverán en los resultados de geocodificación.	String
match_narrative [match_narrative,...] (Opcional)	Especifica cómo se devolverá la narrativa de coincidencia en la clase de entidad geocodificada de salida. Si no se especifica ningún valor de parámetro, se utilizará la configuración de la propiedad de localizador Incluir narración de coincidencia. Este parámetro puede ayudar a comprender mejor cómo se hicieron coincidir las direcciones en la clase de entidad geocodificada. Consulte la página web de Ayuda de ArcGIS REST API para obtener más información sobre el parámetro returnMatchNarrative para geocodeAddresses. `ADD_MATCH_NARRATIVE`—Se agregará un campo denominado `MatchNarrative` a la clase de entidad geocodificada. Este campo contiene el texto narrativo de la coincidencia para cada dirección coincidente. `SPLIT_MATCH_NARRATIVE`—El texto narrativo de coincidencia de un solo campo se extraerá del objeto JSON. El texto narrativo de la coincidencia se analizará, se dividirá en campos individuales y se agregará a la clase de entidad geocodificada.	String

Muestra de código

Ejemplo 1 de GeocodeAddresses (secuencia de comandos independiente)

El siguiente script muestra cómo utilizar la función GeocodeAddresses para geocodificar una tabla de direcciones con un localizador local.

import arcpy

arcpy.env.workspace = "C:\\Geocoding\\atlanta"

# Set local variables
table = "customers.dbf"
locator = "Atlanta_AddressLocator.loc"
field_map = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
                  "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;County <None> VISIBLE NONE;" +
                  "State <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator,
                                 field_map, geocode_result)

Ejemplo 2 de GeocodeAddresses (script independiente)

El siguiente script muestra cómo utilizar la función GeocodeAddresses para geocodificar una tabla de direcciones con un localizador de servidor mediante una conexión AGS.

import arcpy

# Set local variables:
table = r"C:\data\Atlanta.gdb\customers"
locator = r"C:\ags_connections\server_name.ags\Atlanta.GeocodeServer"
field_map = "'Single Line Input' SingleLine VISIBLE NONE"
geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator,
                                 field_map, geocode_result)

Ejemplo 3 de GeocodeAddresses (script independiente)

El siguiente script muestra cómo utilizar la función GeocodeAddresses para geocodificar una tabla de direcciones con un localizador de portal.

Nota:

Si está trabajando con localizadores en su portal, asegúrese de que ha iniciado sesión y de establecerlo como portal activo en ArcGIS Pro. Para acceder a un localizador que está en un portal distinto del portal activo, puede autenticarlo con la función SignInToPortal.

import arcpy

# Set local variables
table = r"C:\data\Atlanta.gdb\customers"
locator = "https://machinename.domain.com/server/rest/services/service_name/GeocodeServer/portal_item_name"
field_map = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
                  "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;County <None> VISIBLE NONE;" +
                  "State <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
                  "Country <None> VISIBLE NONE")
geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

Ejemplo 4 de GeocodeAddresses (script independiente)

El siguiente script de muestra cómo utilizar la función GeocodeAddresses para geocodificar una tabla de direcciones con World Geocoding Service.

Nota:

Al usar ArcGIS World Geocoding Service, esta operación puede consumir créditos.

import arcpy

# Set local variables
table = r"C:\data\Addresses.csv"

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"

field_map = ("\'Address or Place\' Address VISIBLE NONE;Address2 <None> VISIBLE NONE;Address3 <None> VISIBLE NONE;" +
             "Neighborhood <None> VISIBLE NONE;City <None> VISIBLE NONE;Subregion <None> VISIBLE NONE;" +
             "Region <None> VISIBLE NONE;ZIP ZIP <None> VISIBLE NONE;ZIP4 <None> VISIBLE NONE;" +
             "Country <None> VISIBLE NONE")

geocode_result = r"C:\My_Output.gdb\geocode_result"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

Ejemplo 5 de GeocodeAddresses (script independiente)

El siguiente script muestra cómo utilizar la función GeocodeAddresses para geocodificar una tabla de direcciones (en la que todos los datos de dirección están en un solo campo y los datos de país están en un segundo campo) con ArcGIS World Geocoding Service.

Nota:

Al usar ArcGIS World Geocoding Service, esta operación puede consumir créditos.

import arcpy

# Set local variables
table = r"C:\Data\MyDatabase.gdb\DistributionCenters"

# Sign in to Portal
#arcpy.SignInToPortal("https://www.arcgis.com.", "MyUsername", "MyPassword")

locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"

field_map = "'Single Line Input' SingleLine VISIBLE NONE;Country Country VISIBLE NONE"

geocode_result = r"C:\Data\MyDatabase.gdb\DistributionCenters_Geocoded"

arcpy.geocoding.GeocodeAddresses(table, locator, field_map, geocode_result)

Entornos

Palabra clave CONFIG de salida, Sistema de coordenadas de salida

Información de licenciamiento

Basic: Si
Standard: Si
Avanzado: Si

Geocodificar direcciones (Herramientas de geocodificación)

Resumen

Nota:

Uso

Parámetros

Nota:

Nota:

Heredado:

Nota:

Entornos

Información de licenciamiento

Temas relacionados