Skip To Content

Configurar el portal para geocodificar direcciones

Una característica útil de los portales de ArcGIS Enterprise es la capacidad de representar cartográficamente direcciones o topónimos de un archivo de valores separados por comas (CSV), un archivo de Microsoft Excel o una tabla. Para ello, debe asegurarse de que el portal tiene un servicio de localizador válido (para buscar las direcciones o lugares) y un servidor de alojamiento (para leer las direcciones o lugares y enviarlos al servicio de localizador).

Legado:

Los servicios de localizador antes se denominaban servicios de geocodificación. Algunas áreas de la interfaz de usuario del software y la API siguen utilizando el término "servicio de geocodificación" para compatibilidad con versiones anteriores.

Configurar un servicio de localizador

Debe definir un servicio de localizador para el portal con el fin de geocodificar a la vez un elevado número de direcciones o topónimos, por ejemplo, al agregar un archivo CSV que contiene direcciones al Map Viewer. Puede utilizar un servicio de localizador de una organización de ArcGIS Online o puede publicar su propio servicio de localizador (geocodificación) en uno de los servidores federados del portal o un GIS Server independiente.

Se debe configurar el servicio de localizador de ArcGIS Online, con la geocodificación por lotes habilitada, para permitir a los usuarios crear vistas de localizador. Si se elimina el proxy del servicio de geocodificación de ArcGIS Online, las vistas de localizador dejarán de funcionar. Si configuró el servicio de localizador de ArcGIS Online antes de actualizar a ArcGIS Enterprise 10.6.1, debe deshabilitar y volver a habilitar el servicio de utilidades de geocodificación de ArcGIS Online para que admita vistas de localizador.

Consulte Configurar servicios de utilidades para obtener más información sobre cómo configurar un localizador en su portal para habilitar la geocodificación. Para obtener información sobre la configuración de su propio servicio, consulte la siguiente sección.

Configurar su propio servicio de localizador

Los portales de ArcGIS Enterprise utilizan el ArcGIS World Geocoding Service alojado en ArcGIS Online de forma predeterminada. Si su organización dispone de sus propios datos de localizador para buscar direcciones y topónimos, o si su portal no puede acceder a ArcGIS Online, publique un servicio de localizador (geocodificación) y defínalo como localizador de su portal.

Habilite las funciones Sugerir en el servicio de localizador si desea que aparezcan sugerencias de direcciones o topónimos cuando los usuarios realicen búsquedas en el Map Viewer.

  1. Siga las instrucciones de Crear un localizador de direcciones de la ayuda de ArcMap para crear un localizador a partir de sus datos. Si desea usar sugerencias en el Map Viewer, active la opción Sugerir en la herramienta Crear un localizador de direcciones cuando cree el localizador.
  2. Publique el localizador como servicio haciendo clic con el botón derecho sobre el localizador en el árbol de catálogo de ArcMap o ArcCatalog y haciendo clic en Compartir como servicio.

    Para obtener más información sobre cómo publicar un servicio, consulte Cómo publicar un servicio en la ayuda de ArcGIS Server.

  3. Si no ha habilitado las sugerencias en el localizador cuando lo creó, puede habilitarlas en el servicio de localizador después de publicarlo. Abra el Editor de servicio del servicio en ArcMap o ArcGIS Server Manager, haga clic en la pestaña Capacidades y active la operación Sugerir.
  4. Configure el servicio resultante como localizador para su portal. Vaya a Organización > Editar ajustes > Servicios de utilidades.

Configurar un data store relacional con un GIS Server

El sitio de GIS Server definido como servidor de alojamiento del portal debe tener un data store relacional de ArcGIS Data Store configurado.

  1. Instale ArcGIS Data Store.
  2. Cree un data store relacional.

    Al crear el data store relacional, especifique la dirección URL del sitio de GIS Server que desee utilizar como servidor de alojamiento del portal.

Federar el GIS Server con el portal

Antes de designar un sitio de GIS Server como servidor de alojamiento, debe federarlo con el portal. El sitio de GIS Server que federe con el portal debe estar configurado para comunicarse a través de HTTP y HTTPS o solo de HTTPS.

Para obtener instrucciones, consulte Federar un sitio de ArcGIS Server con el portal.

Designar el servidor de alojamiento

Especifique el sitio de GIS Server que acaba de federar con el portal como servidor de alojamiento.

  1. Elija el sitio de GIS Server en la lista desplegable de la sección Servidor de alojamiento, en el panel Servidor.
  2. Haga clic en Save (Guardar).

Configure la herramienta Geocodificar ubicaciones desde tabla para usar Esri World Batch Geocoder y las vistas de localizador

De forma predeterminada, el servicio Esri World Batch Geocoder se comparte con la organización. Las vistas de localizador de Esri World Batch Geocoder no se comparten de ningún modo de forma predeterminada. Para enviar solicitudes de geocodificación por lotes para Esri World Batch Geocoder y vistas de localizador utilizando la herramienta Geocodificar ubicaciones de tabla o utilizando Geocodificar tabla, deberá compartir el servicio con Todos.

  1. Vaya a la pestaña Mi contenido de la página de contenido.
  2. Haga clic en el localizador AGO World Geocoder o en la vista de localizador correspondiente que debe compartir, y abra su página de detalles del elemento.
  3. Haga clic en Compartir en la pestaña Descripción general y active Todos.
  4. Haga clic en Aceptar.

El uso de Esri World Batch Geocoder o una vista de localizador en la herramienta Geocodificar ubicaciones de tabla consume créditos en la organización de ArcGIS Online que utiliza al configurar el localizador (servicio de utilidades de geocodificación) del portal. El número de solicitudes de geocodificación por lotes concurrentes para Esri World Batch Geocoder y para vistas de localizador no se puede configurar y siempre se establece en uno. Si utiliza cualquier otro servicio de localizador con la herramienta Geocodificar ubicaciones de tabla no se consumen créditos y se pueden configurar otros localizadores para enviar varias solicitudes de geocodificación por lotes concurrentes.

Agregar un registro para obtener más comentarios mientras se realiza la geocodificación por lotes

De forma predeterminada, el nivel del mensaje del servicio de geoprocesamiento Herramientas de geocodificación está establecido como Advertencia. Para obtener más información sobre los mensajes de error y mejores actualizaciones sobre el estado de su trabajo de geocodificación por lotes, puede configurar el nivel de registro del servicio de geoprocesamiento Herramientas de geocodificación como Información.

  1. Vaya al Server Manager de su servidor de alojamiento.
  2. Haga clic en la carpeta Utilidades en el directorio Server Manager.
  3. Haga clic en el servicio de geoprocesamiento GeocodingTools.
  4. Haga clic en el encabezado de la izquierda Parámetros y cambie Nivel del mensaje a Información. Después, haga clic en el botón Guardar y reiniciar de la esquina superior derecha.

Cambiar el nivel de registro a Información supondrá una leve pérdida de rendimiento, pero proporcionará un mejor comentario sobre el progreso del trabajo y más información sobre posibles errores, si se dieran. Estas ventajas se pueden consultar tanto en la herramienta Geocodificar ubicaciones desde tabla como en la herramienta Geocodificar tabla.

Configurar la cantidad sugerida de solicitudes de geocodificación por lotes concurrentes para el localizador

El localizador del portal también lo puede utilizar el servicio de geoprocesamiento GeocodingTools que se ejecuta en el sitio de GIS Server federado. El servicio de geoprocesamiento puede enviar varias solicitudes concurrentes al servicio de utilidades de geocodificación para agilizar la ejecución general de la geocodificación por lotes. La cantidad de solicitudes concurrentes que realiza el servicio de geoprocesamiento la puede configurar un administrador del portal. Si el ‭servicio de geoprocesamiento está realizando demasiadas solicitudes concurrentes al localizador, es posible que funcione con deficiencias, lo que podría dar lugar a un incremento de los errores al ejecutar el servicio de geoprocesamiento. Por este motivo, el administrador debería definir la cantidad de instancias que se utilizan en el servicio de geoprocesamiento según la cantidad de instancias disponibles para el servicio de localizador, además de configurar la cantidad de solicitudes de geocodificación por lotes concurrentes que se pueden realizar desde cualquier instancia del servicio de geoprocesamiento GeocodingTools.

Se recomienda que la cantidad de instancias para el servicio de localizador siempre sea igual o superior a la cantidad de instancias disponibles para el servicio de geoprocesamiento GeocodingTools. Se debería establecer una cantidad de solicitudes de geocodificación por lotes concurrentes proporcional a la cantidad de instancias disponibles para el localizador y para los servicios de geoprocesamiento. Por ejemplo, si hay ocho instancias disponibles para el servicio de localizador y dos instancias disponibles para el servicio de geoprocesamiento, establezca las solicitudes de geocodificación por lotes concurrentes en cuatro. Cuando se ejecuta el servicio de geoprocesamiento, envía cuatro solicitudes de geocodificación por lotes concurrentes al servicio de localizador. En caso de que haya más instancias disponibles para el servicio de localizador, ajuste la cantidad de solicitudes de geocodificación por lotes concurrentes apropiadamente para maximizar la utilización de instancias para el servicio de localizador.

Tenga en cuenta que Esri World Batch Geocoder no se puede configurar para usar más solicitudes concurrentes. La configuración siguiente se aplica al resto de servicios de localizador publicados que están configurados como servicios de utilidades.

Siga estos pasos para definir la cantidad sugerida de solicitudes de geocodificación por lotes concurrentes para el servicio de localizador:

  1. Acceda a la ubicación compartida del Directorio de Portal for ArcGIS e inicie sesión como miembro con privilegios administrativos. La dirección URL tiene el formato https://webadaptorhost.domain.com/<webadaptorname>/sharing/rest.
  2. Acceda a Inicio > Portales > Auto.
  3. En la parte inferior de la página, haga clic en Actualizar.
  4. En el cuadro de texto Servicio de geocodificación, verá los servicios de localizador actualmente configurados con el portal. Para los servicios que permiten la geocodificación por lotes (los servicios que tienen la propiedad batchestablecida en true), puede configurar la cantidad sugerida de solicitudes de geocodificación por lotes concurrentes. Elija el servicio que desee configurar con esta propiedad. El JSON en el cuadro de texto Servicio de geocodificación tendrá el formato siguiente:
    [{
            "url" : "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
            "northLat" : "Ymax",
            "southLat" : "Ymin",
            "eastLon" : "Xmax",
            "westLon" : "Xmin",
            "name" : "Esri World Geocoder",
            "batch": false,
            "suggest" : true
        }, {
            "url" : "https://machine.domain.com/server/rest/services/Locators/USA/GeocodeServer",
            "name" : "Streetmap Premium USA Geocoder",
            "placeholder" : "Find address or place",
            "singleLineFieldName" : "SingleLine",
            "batch" : true,
            "placefinding" : true,
            "suggest" : true,
            "zoomScale" : 10000
        }]

  5. Agregue la propiedad numBatchThreads a todos los servicios de localizador que desee utilizar con el servicio de geoprocesamiento GeocodingTools. Para definir el valor numBatchThreads, primero determine la cantidad de solicitudes de geocodificación por lotes concurrentes que desee habilitar para un determinado servicio de localizador y, a continuación, defina la propiedad con esa cifra. Tenga en cuenta que, para configurar numBatchThreads en el servicio de localizador, el servicio debe tener batch establecido en true.

    En este ejemplo, la cantidad permitida de solicitudes de geocodificación por lotes concurrentes para el servicio de utilidades del geocodificador Streetmap Premium USA está establecida en cuatro.

    [{
            "url" : "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
            "northLat" : "Ymax",
            "southLat" : "Ymin",
            "eastLon" : "Xmax",
            "westLon" : "Xmin",
            "name" : "Esri World Geocoder",
            "batch": false,
            "suggest" : true
        }, {
            "url" : "https://machine.domain.com/server/rest/services/Locators/USA/GeocodeServer",
            "name" : "Streetmap Premium USA Geocoder",
            "placeholder" : "Find address or place",
            "singleLineFieldName" : "SingleLine",
            "batch" : true,
            "placefinding" : true,
            "suggest" : true,
            "zoomScale" : 10000,
            "numBatchThreads" : 4
        }]

  6. Una vez que haya actualizado el JSON en el cuadro de texto Servicio de geocodificación, haga clic en Actualizar organización en la parte inferior de la página.

Utilice la url del servicio de localizador con la propiedad numBatchThreads agregada como geocodeServiceURL en las tareas AnalyzeGeocodeInput y BatchGeocode. Para obtener información sobre cómo ejecutar las herramientas en el servicio GeocodingTools mediante tareas de API REST de ArcGIS, consulte la documentación de la API REST de ArcGIS.