| 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 Campo único 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) | Este parámetro esta inactivo en ArcGIS Pro. Se conserva para compatibilidad con las versiones anteriores de ArcGIS Desktop. | 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 de la ubicación de dirección predeterminada. Consulte la página web de la Ayuda de API REST de ArcGIS para obtener más información sobre el parámetro locationType para geocodeAddresses.
| 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 API REST de ArcGIS 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. | String |
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 utilizar el ArcGIS World Geocoding Service, esta operación puede consumir créditos.
La realización de operaciones de geocodificación mediante ArcGIS World Geocoding Service requiere una cuenta de organización de ArcGIS y consume 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 de 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.
Obtenga más información sobre cómo repetir la geocodificación de los resultados de geocodificación.
Se requiere suscripción a ArcGIS Online for organizations para geocodificar una tabla de direcciones con el 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
.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
. 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 
.Más información sobre la definición de las características de altura de las capas
Parámetros
arcpy.geocoding.GeocodeAddresses(in_table, address_locator, in_address_fields, out_feature_class, {out_relationship_type}, {country}, {location_type}, {category}, {output_fields})| 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 de direcciones 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 con la dirección, por ejemplo: EE. UU. 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. 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.
| 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 se asigne el valor del parámetro in_table al campo Country en el parámetro in_address_fields. 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 la Ayuda de API REST de ArcGIS para obtener más información sobre el parámetro locationType para geocodeAddresses.
| 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 API REST de ArcGIS 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.
| String |
Muestra de código
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)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)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)El siguiente script muestra cómo utilizar la función GeocodeAddresses para geocodificar una tabla de direcciones con el ArcGIS World Geocoding Service.
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.
Nota:
Al utilizar el 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)El siguiente script muestra cómo utilizar la funciónGeocodeAddresses 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 el ArcGIS World Geocoding Service.
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.
Nota:
Al utilizar el 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)Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí