Geocodificar ubicaciones desde tabla (Geocodificación)

Resumen

Geocodifica las tablas alojadas, utilizando localizadores alojados en un portal de ArcGIS Enterprise que crea una capa de entidades alojada que contiene los resultados geocodificados.

Esta herramienta automatiza el proceso de geocodificar las tablas publicadas en el portal y guarda la salida en el portal. Si no necesita guardar los resultados de geocodificación en el portal, utilice el panel Geocodificar tabla o la herramienta Geocodificar direcciones.

Nota:

Debe tener privilegios de publicador o administrador en el portal para ejecutar esta herramienta. Si es miembro de un rol personalizado, asegúrese de que el administrador del portal le haya otorgado el privilegio para Publicar capas web alojadas.

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 se dividen en varios campos, como Address, City, State y ZIP para una dirección general de los Estados Unidos. También se admite un campo de entrada único 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.

  • Se requiere ArcGIS Enterprise 10.6 o posterior para usar la herramienta.

  • Use un localizador del portal de ArcGIS Enterprise configurado para utilizar varios subprocesos para mejorar el rendimiento de geocodificación.

  • La tabla de entrada debe ser una tabla que esté alojada o que se haya publicado en un portal ArcGIS Enterprise. Las tablas alojadas se consideran parte de las capas de entidades alojadas y se deben crear como elementos del portal para poder usarlas en la herramienta. Para obtener más detalles, consulte Publicar capas de entidades alojadas.

  • La capa de entidades alojada de salida se guarda en la misma referencia espacial que el localizador de direcciones. Puede cambiar la referencia espacial de la capa de entidades de salida estableciendo un sistema de coordenadas de salida diferente en la configuración del entorno de la herramienta.

  • La capa de entidades alojada de salida contendrá toda la información de geocodificación relevante, por ejemplo, puntuación, estado y dirección coincidente de cada registro, además de los valores de la tabla de entrada original. 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. El resultado de geocodificación de esta herramienta contiene una instantánea estática de la tabla de entrada original, por lo que agregar o actualizar valores en la tabla original no actualizará los resultados del servicio de entidades de salida. Vuelva a ejecutar la herramienta para crear un servicio de entidades de salida que contenga dichos cambios.

    Obtenga más información sobre cómo repetir la geocodificación de los resultados de geocodificación.

  • Cuando se utiliza un localizador de entrada creado con datos sensible a valores z, la herramienta devolverá resultados no sensible a valores z. Esta herramienta solo admite salidas 2D.

  • La herramienta no aplica las configuraciones de una vista de localizador creada en ArcGIS Pro 3.2 cuando se utiliza como valor del parámetro Localizador de direcciones.

Parámetros

EtiquetaExplicaciónTipo de datos
Tabla de entrada

La tabla del portal que contiene las direcciones o los lugares que se desea geocodificar.

Record Set
Localizador de direcciones

El localizador de portal que se utilizará para geocodificar la tabla de entrada del portal.

Puede elegir un localizador de la lista rellenada de localizadores del portal activo o navegar por el portal activo en busca de otros localizadores disponibles. Los localizadores que hayan sido definidos como servicios de utilidad en el portal activo estarán disponibles de forma predeterminada. Si el localizador de portal que desea usar no aparece en la lista rellenada, pida a su administrador de portal que agregue el localizador como un servicio de utilidad del portal y configure el localizador para la geocodificación por lotes.

Nota:

La opción ArcGIS World Geocoding Service está deshabilitada para esta herramienta. Use la herramienta Geocodificar direcciones si desea utilizar ArcGIS World Geocoding Service.

Address Locator
Asignación de campos de dirección

Los campos de dirección que utiliza el localizador se asignan a campos de la tabla de entrada de direcciones. 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 Campo único y Campo de país si la dirección completa, por ejemplo, 303 Peachtree St NE, Atlanta, GA 30308, y el país, por ejemplo, EE. UU., se dividen en campos separados como Address y Country.

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 se convierten en 100 Main St Apt 140 al geocodificar.

Si no asigna un campo de dirección de entrada opcional empleado por el localizador a un campo de la tabla de entrada de direcciones, especifique que no hay asignación utilizando <Ninguno> en lugar de un nombre de campo.

Field Info
Nombre de capa de entidades de salida

El nombre de la capa de entidades geocodificada de salida que se creará en el portal.

String
País
(Opcional)

El país o países en los que se buscarán las direcciones geocodificadas.

Este parámetro está disponible para los localizadores que admiten un parámetro de país y limitará la geocodificación a los países especificados. Especificar un país mejorará la precisión de la geocodificación en la mayoría de los casos. Si especifica Campo único y Campo de país para el parámetro Asignación de campos de dirección y asigna un campo que representa los países enel valor del parámetro Tabla de entrada al campo Country para el parámetro Asignación de campos de dirección, el valor de país de la Tabla de entrada sobreescribirá el parámetro País.

Esta opción está limitada al país o los países especificados. Cuando no se especifica ningún país, la geocodificación se realiza utilizando todos los países compatibles del localizador.

El parámetro País no es compatible con todos los localizadores.

String
Tipo de ubicación preferida
(Opcional)

Especifica la geometría de salida preferida que se devolverá para las coincidencias de PointAddress. Las opciones para este parámetro son Ubicación de generación de rutas, que es la ubicación del lado de la calle, que puede usarse para la generación de rutas, y Ubicación de dirección, que es la ubicación que representa el tejado o el centroide de parcela que corresponde a la dirección. Si la ubicación deseada no existe en los datos, se devolverá la ubicación predeterminada. En los resultados de geocodificación con Addr_type=PointAddress, los valores del atributo x,y describen las coordenadas de la dirección a lo largo de la calle, y los valores de DisplayX y DisplayY describen las coordenadas de tejado o centroide de edificio.

Este parámetro no es compatible con todos los localizadores.

  • Ubicación de direcciónSe 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.
  • Ubicación de generación de rutasSe 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. Esta es la opción predeterminada.
String
Categoría
(Opcional)

Limita los tipos de lugares que busca el localizador, eliminando así las coincidencias de falsos positivos y aumentando potencialmente 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. En general, este parámetro se puede utilizar para:

  • Limitar las coincidencias de tipos de lugares o niveles de dirección específicos
  • Evitar coincidencias de reserva en niveles de dirección no deseados
  • Evitar la ambigüedad en búsquedas de coordenadas

Este parámetro no es compatible con todos los localizadores.

String
Campos de salida
(Opcional)

Especifica los campos de salida del localizador que se devolverán en los resultados de geocodificación.

  • TodasIncluye todos los campos de salida del localizador disponibles en los resultados de geocodificación. Esta es la opción predeterminada.
  • Solo ubicaciónAlmacena el campo Shape en los resultados de geocodificación. Los nombres de campo originales del valor del parámetro Tabla de entrada se mantendrán con sus nombres de campo originales.
  • MínimaAgrega 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. Los nombres de campo originales del valor del parámetro Tabla de entrada se mantendrán.
  • Campos de usuario y mínimoAgrega los siguientes campos que describen la ubicación y el grado de coincidencia de la información del localizador, así como cualquier campo de salida personalizado y definido por el usuario en los resultados de geocodificación: Shape, Status, Score, Match_type, Match_addr y Addr_type. Los nombres de campo originales del valor del parámetro Tabla de entrada se mantendrán.
Nota:

Este parámetro se puede utilizar con localizadores de entrada creados con las herramientas Crear localizador o Crear localizador de entidades 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

Salida derivada

EtiquetaExplicaciónTipo de datos
Capa de salida

Un hipervínculo a la capa de entidades de resultados geocodificados de salida en el portal. El nombre de la capa de entidades se deriva del valor de Nombre de capa de entidades de salida.

Feature Set

arcpy.geocoding.GeocodeLocationsFromTable(in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category}, {output_fields})
NombreExplicaciónTipo de datos
in_table

La tabla del portal que contiene las direcciones o los lugares que se desea geocodificar.

Record Set
in_address_locator

El localizador de portal que se utilizará para geocodificar la tabla de entrada del portal.

Puede elegir un localizador de la lista rellenada de localizadores del portal activo o navegar por el portal activo en busca de otros localizadores disponibles. Los localizadores que hayan sido definidos como servicios de utilidad en el portal activo estarán disponibles de forma predeterminada. Si el localizador de portal que desea usar no aparece en la lista rellenada, pida a su administrador de portal que agregue el localizador como un servicio de utilidad del portal y configure el localizador para la geocodificación por lotes.

Nota:

La opción ArcGIS World Geocoding Service está deshabilitada para esta herramienta. Use la herramienta Geocodificar direcciones si desea utilizar ArcGIS World Geocoding Service.

Address Locator
address_fields
[input_locator_field, table_field_name]

Cada asignación de campos en este parámetro está en el formato input_locator_field, table_field_name, donde input_locator_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 campo de entrada único 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 se convierten en 100 Main St Apt 140 al geocodificar.

Si no asigna un campo de dirección de entrada opcional empleado por el localizador a un campo de la tabla de entrada de direcciones, especifique que no hay asignación utilizando <None> en lugar de un nombre de campo.

Field Info
output_name

El nombre de la capa de entidades geocodificada de salida que se creará en el portal.

String
country
[country,...]
(Opcional)

El país o países en los que se buscarán las direcciones geocodificadas.

Este parámetro está disponible para los localizadores que admiten un parámetro de país y limitará la geocodificación a los países especificados. Especificar un país mejorará la precisión de la geocodificación en la mayoría de los casos. Si un campo que representa a los países en in_table se asigna al campo Country de address_fields, el valor del país del parámetro in_table invalidará el parámetro country.

Esta opción está limitada al país o los países especificados. Cuando no se especifica ningún país, la geocodificación se realiza en todos los países compatibles del localizador.

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.

El parámetro country no es compatible con todos los localizadores.

String
location_type
(Opcional)

Especifica la geometría de salida preferida que se devolverá para las coincidencias de POINT_ADDRESS. Las opciones para este parámetro son ROUTING_LOCATION, que es la ubicación del lado de la calle, que puede usarse para la generación de rutas, y ADDRESS_LOCATION, que es la ubicación que representa el tejado, el centroide de parcela que corresponde a la dirección o una entrada principal. Si la ubicación deseada no existe en los datos, se devolverá la ubicación predeterminada de ROUTING_LOCATION. En los resultados de geocodificación con Addr_type=PointAddress, los valores del atributo x,y describen las coordenadas de la dirección a lo largo de la calle, y los valores de DisplayX y DisplayY describen las coordenadas de tejado o centroide de edificio. 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.

Este parámetro no es compatible con todos los localizadores.

  • ADDRESS_LOCATIONSe 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.
  • ROUTING_LOCATIONSe 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. Esta es la opción predeterminada.
String
category
[category,...]
(Opcional)

Limita los tipos de lugares que busca el localizador, eliminando así las coincidencias de falsos positivos y aumentando potencialmente 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. En general, este parámetro se puede utilizar para:

  • Limitar las coincidencias de tipos de lugares o niveles de dirección específicos
  • Evitar coincidencias de reserva en niveles de dirección no deseados
  • Evitar la ambigüedad en búsquedas de coordenadas

Este parámetro no es compatible con todos los localizadores.

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.

Nota:

Este parámetro se puede utilizar con localizadores de entrada creados con las herramientas Crear localizador o Crear localizador de entidades 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.

  • ALLIncluye todos los campos de salida del localizador disponibles en los resultados de geocodificación. Esta es la opción predeterminada.
  • LOCATION_ONLYAlmacena el campo Shape en los resultados de geocodificación. Los nombres de campo originales del valor del parámetro in_table se mantendrán con sus nombres de campo originales.
  • MINIMALAgrega 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. Los nombres de campo originales del valor del parámetro in_table se mantendrán.
  • MINIMAL_AND_USERAgrega 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, así como cualquier campo de salida personalizado y definido por el usuario: Shape, Status, Score, Match_type, Match_addr y Addr_type. Los nombres de campo originales del valor del parámetro in_table se mantendrán.
String

Salida derivada

NombreExplicaciónTipo de datos
output_layer

Un hipervínculo a la capa de entidades de resultados geocodificados de salida en el portal. El nombre de la capa de entidades se deriva del valor de Nombre de capa de entidades de salida.

Feature Set

Muestra de código

Ejemplo de GeocodeLocationsFromTable (script independiente)

El siguiente script independiente muestra cómo utilizar la función GeocodeLocationsFromTable para geocodificar una capa de tabla alojada.

Nota:
Si está trabajando con localizadores en su portal, asegúrese de que ha iniciado sesión y configúrelo como el portal activo en ArcGIS AllSource. Para acceder a un localizador que está en un portal distinto del portal activo, autentíquelo con la función SignInToPortal.

import arcpy

# Input is a hosted table
input_table = "https://<machine_name>/server/rest/services/Hosted/<item_name>/FeatureServer/<table_number>"

# This tool works with locators on your portal
in_locator = "https://<machine_name>/server/rest/services/<locator_name>/GeocodeServer/<locator_name>"

# The easiest way to generate a field mapping is to run the tool in ArcGIS 
# Pro and right-click the green success ribbon and click "Copy Python command"
field_mapping =  "'Street or Intersection' address VISIBLE NONE;'City or Placename' <None> VISIBLE NONE;State <None> VISIBLE NONE;'ZIP Code' zip VISIBLE NONE"
output_name = "geocoding_output"

# Optional geocoding parameters. Only some are supported depending on the 
# in_locator that you use.
country = None
location_type = None
category = None

# The output is a hosted feature layer on your portal. To retrieve the
# output, go to your portal and look for a new item with the output_name that 
# you entered.
arcpy.geocoding.GeocodeLocationsFromTable(input_table, in_locator, 
                                          field_mapping, output_name, country, 
                                          location_type, category)