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 se ha diseñado para automatizar el proceso de geocodificar las tablas publicadas en el portal y guardar la salida en el portal. Si no le interesa 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 usar 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 o en varios campos. Un 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.
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.
Utilizar un localizador en el portal de ArcGIS Enterprise configurado para utilizar varios subprocesos mejorará el rendimiento de geocodificación.
La herramienta requiere que se use como tabla de entrada una tabla que esté alojada o haya sido publicada en un portal de 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. Es posible cambiar la referencia espacial de la capa de entidades de salida al establecer 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 geocodificar utilizando la herramienta Repetir geocodificación de direcciones o la opción Repetir geocodificación de direcciones que abre el panel Repetir geocodificación de 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 los valores en la tabla original no actualizará los resultados del servicio de entidades de salida. Será necesario volver a ejecutar la herramienta para crear un nuevo servicio de entidades de salida que contenga estos cambios.
Obtenga más información sobre cómo repetir la geocodificación de los resultados de geocodificación.
Sintaxis
GeocodeLocationsFromTable(in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category})| Parámetro | Explicación | Tipo de datos |
in_table | La tabla del portal que contiene direcciones o 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. Una lista rellenada de localizadores del portal activo. Puede seleccionar un localizador de esta lista o buscar en el portal activo 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 almacena 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. 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 decide no asignar 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 |
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 localizadores compatibles con un parámetro de país y limita la geocodificación a los países seleccionados. Si realiza una selección de países, 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 la Tabla de entrada se asigna el Campo de dirección de entrada de Country, el valor del país de la Tabla de entrada redefinirá el parámetro País. Cuando no se especifica ningún país, la geocodificación se ejecuta con todos los países compatibles del localizador. El valor de entrada se debería especificar siguiendo los códigos de países de 3 caracteres de la norma ISO 3166-1. País no es compatible con todos los localizadores. | String |
location_type (Opcional) | Especifica la geometría de salida preferida para las coincidencias POINT_ADDRESS. Las opciones para este parámetro son ROUTING_LOCATION, un lado de la ubicación de la calle, que puede usarse para generación de rutas, o ADDRESS_LOCATION, la ubicación que representa el tejado o 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 volverá a 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, mientras que los valores de DisplayX y DisplayY describen las coordenadas de tejado o centroide de edificio. Consulte la página web de la ayuda de la API REST para más información sobre el parámetro locationType para reverseGeocode. Este parámetro no es compatible con todos los localizadores.
| 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 ejecuta con todas las categorías compatibles. No todos los valores de categoría son compatibles con todas las ubicaciones y países. En general, el parámetro Categoría se puede utilizar para:
Este parámetro no es compatible con todos los localizadores. Consulte la página web de Ayuda de la API REST para obtener más información sobre el filtrado por categoría. | String |
Salida derivada
| Nombre | Explicación | Tipo 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 texto especificado en el Nombre de la capa de entidades de salida. | Conjunto de entidades |
Muestra de código
El siguiente script independiente muestra cómo utilizar la función GeocodeLocationsFromTable para geocodificar una capa de tabla alojada.
import arcpy
arcpy.SignInToPortal("https://<machine_name>/<portal_web_adaptor_name>",
'<username>', '<password>')
# 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 by running 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
# Note that 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)Entornos
Información de licenciamiento
- Basic: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
- Standard: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis
- Advanced: Requiere su cuenta de ArcGIS Enterprise que tendrá el privilegio Realizar análisis