Geocodificación y geobúsqueda

Los localizadores le permiten buscar direcciones y lugares que se pueden visualizar sobre un mapa, se pueden insertar como paradas en una ruta o se pueden cargar como valores de entrada para realizar un análisis espacial. ArcGIS Online incluyen geobúsqueda y geocodificación de este modo:

  • La geobúsqueda (también conocida como búsqueda de ubicaciones): encontrar una dirección o un punto de interés y ampliar el mapa a esa ubicación. El resultado se puede mostrar sobre el mapa, pero no se almacena de ningún modo para usos posteriores. La geobúsqueda está disponible para cualquier usuario que acceda al Visor de mapas, Map Viewer Classic o una aplicación pública que incluya una búsqueda de ubicaciones sobre un mapa. No requiere una cuenta de organización ni consumir créditos (pero el número de geobúsquedas está limitado a 1 millón al mes).
  • Geocodificación: convertir una dirección o un lugar en una coordenada x,y e incorporar el resultado a un registro existente en una base de datos. No siempre implica la representación cartográfica, pero colocar los resultados sobre un mapa puede formar parte del flujo de trabajo. La geocodificación por lotes y la geocodificación inversa entran dentro de esta categoría. Se necesita una cuenta de organización con el privilegio de geocodificación de contenido Premium para acceder a ArcGIS World Geocoding Service, y a cualquier vista de él, para la geocodificación por lotes.

    Nota:

    La geocodificación inversa no es compatible con vistas de ArcGIS World Geocoding Service.

De forma predeterminada, ArcGIS Online utiliza ArcGIS World Geocoding Service para buscar direcciones, ciudades, lugares emblemáticos, nombres de empresas y códigos postales en más de 100 países de todo el mundo. Además, ArcGIS World Geocoding Service se utiliza para buscar la ubicación de coordenadas x,y mediante la latitud y la longitud, así como sistemas de referencia de coordenadas, por ejemplo, el Sistema de Referencia de Cuadrícula Militar (MGRS) y Cuadrícula Nacional de Estados Unidos (USNG).

Si su organización desea optimizar los resultados de búsqueda para direcciones y lugares de interés, los miembros que tengan privilegios para crear contenido pueden crear una nueva vista de ArcGIS World Geocoding Service para buscar solo tipos específicos de ubicaciones dentro de un área de interés. Por ejemplo, puede crear una vista de localizador para limitar los resultados de búsqueda a un país o área concretos o para devolver solo resultados pertenecientes a una categoría concreta, por ejemplo, direcciones de calles o aeropuertos. Cuando haya creado una vista de localizador, los miembros con el rol de administrador predeterminado pueden configurar la organización para que utilice su vista de localizador cuando los miembros realicen geobúsquedas.

Nota:

Usar ArcGIS World Geocoding Service o vistas de este localizador para la geocodificación por lotes (incluido publicar archivos CSV o Microsoft Excel como capas de entidades alojadas) consume créditos. Utilizar localizadores para geobúsquedas no consume créditos.

Se necesita una cuenta de organización con el privilegio de geocodificación de contenido Premium para usar vistas de localizador para la geocodificación por lotes.

Además, si su organización necesita geocodificar direcciones o lugares basándose en los datos propios de la organización, los administradores pueden configurar su organización para que utilice sus propios localizadores que se ejecutan en un sitio de ArcGIS Server, para la geobúsqueda, la geocodificación o ambas. Por ejemplo, una organización petrolera podría agregar localizadores para buscar sus propios pozos de petróleo, o una ciudad podría agregar un localizador para encontrar sus bocas de incendios.

Si agrega localizadores o vistas de localizador adicionales, los miembros ven una flecha en el cuadro de geobúsqueda y pueden elegir qué localizador o vista desean usar.

Crear una vista de localizador

Puede crear una nueva vista de ArcGIS World Geocoding Service para buscar únicamente tipos de ubicaciones concretos dentro de un área de interés. Por ejemplo, puede querer una vista de localizador para limitar los resultados de búsqueda a un área concreta o para imponer un nivel concreto de precisión cuando los miembros realicen geocodificación por lotes de direcciones.

Para crear y configurar una vista de localizador, haga lo siguiente:

  1. Compruebe que haya iniciado sesión en su organización y que tenga privilegios para crear contenido.
  2. En la pestaña Mi contenido de la página de contenido, haga clic en Nuevo elemento y en Localizador (vista).
  3. Introduzca un título y, opcionalmente, elija la carpeta en la que desea guardar el elemento del localizador y especifique las etiquetas y el resumen para el localizador.
  4. Haga clic en Guardar para crear el elemento de vista de localizador.

    La página de elemento de la vista de localizador que creó se abre en la pestaña Configuración.

  5. En la parte superior de la pestaña Configuración, haga clic en Configuración de localizador (vista).
  6. En el menú desplegable, seleccione el tipo de ubicación que desee encontrar:
    • Todos los tipos: elija esta opción si no desea restringir los tipos de ubicaciones devueltas.
    • Direcciones, códigos postales y lugares poblados: elija esta opción para limitar los resultados a calles, ciudades, estados o códigos postales.
    • Coordenadas: elija esta opción para limitar los resultados a MGRS o a un formato concreto para Latitud, Longitud.
    • Lugares de interés: elija esta opción para limitar los resultados a los nombres de lugares o hitos.
  7. Si elige una categoría distinta de Todos los tipos en el paso anterior, afine aún más el filtro de ubicaciones según sea necesario, activando para ello las casillas de las categorías en las que desee buscar. Por ejemplo:
    • Si elige Direcciones, códigos postales y lugares poblados y solo desea que ArcGIS World Geocoding Service devuelva coincidencias con dirección o mejores, active las casillas Dirección de punto y Dirección.
    • Si elige Coordenadas y desea que Latitud, Longitud sea el formato de coordenadas aceptado, active la casilla Latitud, Longitud.
    • Si elige Lugares de interés y solo desea que ArcGIS World Geocoding Service devuelva coincidencias de aeropuertos, active la casilla Aeropuerto.
  8. Especifique dónde desea buscar las ubicaciones, de la forma siguiente:
    • Cualquier lugar del mundo: seleccione esta opción para buscar ubicaciones en todo el globo.
    • En países seleccionados: seleccione esta opción para buscar ubicaciones en países específicos. Busque o navegue a los países que desee y selecciónelos de uno en uno hasta haber hecho todas las selecciones.
      Nota:

      Si los datos contienen el valor de un país, los resultados de búsqueda incluirán cualquier país expresamente definido en los datos. Sin embargo, si los países no se definen expresamente en los datos, los resultados se limitarán al país o los países que defina con la configuración de esta vista de localizador.

    • Dentro de un área especificada: seleccione esta opción para definir la extensión de un área para la búsqueda de ubicaciones. Haga clic en Definir área y defina la extensión. Cuando haya finalizado, haga clic en Aceptar.
  9. Si selecciona Direcciones, códigos postales y lugares poblados o Lugares de interés para el tipo de ubicación que desea buscar, elija una de las siguientes opciones para especificar su preferencia de visualización de ubicaciones:
    • A un lado de la calle (ubicación de generación de rutas)
    • En el tejado o centroide de parcela (ubicación de dirección)
    Nota:

    Es posible que su preferencia no esté disponible para todas las ubicaciones. Si la preferencia seleccionada no está disponible para una ubicación, dicha ubicación se mostrará con la mayor precisión posible.

  10. Especifique sus preferencias para devolver nombres de ciudades de la siguiente manera:
    • Según la definición para el país: mantenga esta opción seleccionada para devolver el nombre de ciudad predeterminado definido para el país. Por ejemplo, las ciudades de Estados Unidos se devuelven de forma predeterminada con el nombre de ciudad postal.
    • Nombre de ciudad postal: seleccione esta opción para devolver el nombre de ciudad postal principal, aunque no sea el nombre de ciudad introducido en la búsqueda. El nombre de ciudad postal es el nombre principal asignado al código postal de la dirección. Por ejemplo, el código postal 45420 de Ohio tiene el valor de ciudad postal principal de Dayton. Se asigna este código postal a las direcciones de la ciudad de Kettering, lo que significa que las búsquedas de direcciones en Kettering se devuelven como direcciones de Dayton. Si se selecciona esta opción y un miembro de la organización busca 2109 E Dorothy Ln, Kettering, OH, 45420, se devuelve la etiqueta coincidente 2109 E Dorothy Ln, Dayton, Ohio, 45420, a pesar de que la dirección se encuentra dentro de los límites de la ciudad de Kettering.
    • Nombre de ciudad local: seleccione esta opción para devolver el nombre de ciudad como se conoce localmente, aunque no sea el nombre de ciudad introducido en la búsqueda. El nombre de ciudad local es el nombre de la ciudad donde está la dirección y puede ser distinto de la ciudad postal. Por ejemplo, si se selecciona esta opción, buscar 2109 E Dorothy Ln, Dayton, OH, 45420 (una dirección en Kettering, Ohio) devuelve la etiqueta coincidente de 2109 E. Dorothy Ln, Kettering, Ohio, 45420, a pesar de que Dayton se incluye en la cadena de búsqueda y el código postal introducido tiene el valor de ciudad postal de Dayton.
    • Nombre de ciudad asignado: seleccione esta opción para devolver el valor de nombre de ciudad asignado cuando el nombre de ciudad introducido en una búsqueda coincida con cualquier valor de nombre de ciudad local o nombre de ciudad postal.
    Nota:

    No todas las direcciones tienen valores de ciudad postal o local asignados. Si la ciudad de elección solicitada no existe en los datos, se devuelve otro valor de ciudad en función de los formatos de direcciones predeterminados.

  11. Especifique sus preferencias para devolver nombres de calles de la siguiente manera:
    • Según la definición para el país: mantenga esta opción seleccionada para devolver el nombre de calle predeterminado. El nombre de calle predeterminado es el nombre de calle asignado.
    • Nombre de calle asignado: seleccione esta opción para devolver el valor de nombre de calle asignado cuando el nombre de calle introducido en una búsqueda coincida con cualquier nombre de calle admitido asignado a una dirección.
    • Nombre de calle principal: seleccione esta opción para devolver el nombre de calle principal, aunque no sea el nombre de calle alternativo introducido en la búsqueda. El nombre de calle principal es el nombre principal asignado a una calle. Por ejemplo, si se selecciona esta opción, buscar CA-138, Pearblossom, CA devuelve la etiqueta coincidente de Pearblossom Hwy, Pearblossom, California, 93553.
  12. Haga clic en Guardar para guardar sus ajustes de la vista de localizador.
  13. Compartir su vista de localizador con el público o su organización.

    Debe compartir la vista de localizador para que esté disponible para los miembros de su organización o para el público. Una vez compartida, un administrador puede agregarla a la lista de localizadores de su organización, que los miembros pueden utilizar para la geobúsqueda y la geocodificación por lotes.

    Nota:

    Los usuarios anónimos solo tendrán acceso a su vista de localizador si usted la comparte con el público. Las vistas de localizador compartidas con la organización e incluidas en la lista de localizadores de su organización únicamente son accesibles para los miembros de la organización. Los usuarios anónimos no podrán realizar geobúsquedas en ninguna aplicación mediante localizadores que solo estén compartidos con la organización.

Si su vista de localizador se agrega a la lista de localizadores de la organización, recomendamos que habilite la protección contra eliminación en el elemento de localizador para evitar el borrado accidental. Una vez agregada, si decide eliminar su vista de localizador en un futuro, el administrador debe eliminarla primero de la lista de localizadores de la organización.

Tipos y categorías de ubicaciones

Esta sección describe los tipos, categorías y subcategorías de ubicaciones disponibles al configurar la vista de localizador.

Direcciones, códigos postales y lugares poblados

Si selecciona Direcciones, códigos postales y lugares poblados como los tipos de ubicaciones que desea buscar, puede afinar aún más los resultados de búsqueda de la vista de localizador seleccionando las categorías y subcategorías en las que desea buscar. Están disponibles las siguientes categorías de Direcciones, códigos postales y lugares poblados:

  • Dirección: al seleccionar esta categoría, se incluyen automáticamente las subcategorías de direcciones enumeradas en la tabla que aparece a continuación. Esta categoría limita los resultados de búsqueda a los lugares que pueden categorizarse como direcciones, mientras que filtra y excluye los resultados de lugares de interés, códigos postales, países o estados. Para unos resultados de búsqueda más precisos, elija cualquier combinación de subcategorías de direcciones que cumplan sus requisitos de búsqueda.
  • Postal: al seleccionar esta categoría, los resultados de búsqueda se limitan a cualquier tipo de coincidencia de código postal, incluidos los formatos de código postal de 5 dígitos y más largos. Para limitar los resultados de búsqueda a las coincidencias que tengan al menos este nivel de precisión, seleccione tanto la categoría Postal y la categoría de nivel superior Dirección.
  • Lugar poblado: al seleccionar esta categoría, se incluyen automáticamente todas las subcategorías de lugares poblados enumeradas en la tabla que aparece a continuación. Esta categoría limita los resultados de búsqueda a las divisiones administrativas (o límites), tales como ciudades, provincias o países, mientras que filtra y excluye los resultados de direcciones, lugares de interés o códigos postales. Para unos resultados de búsqueda más precisos, elija cualquier combinación de subcategorías de lugares poblados que cumplan sus requisitos de búsqueda.

CategoríaSubcategoríaDescripción

Dirección

Dirección de punto

Una dirección de punto es una dirección postal basada en puntos que representan las ubicaciones de casas y edificios. Las direcciones de punto representan el tejado, o la ubicación real de la dirección. Normalmente, es el nivel de coincidencia más exacto desde el punto de vista espacial. Los datos de referencia contienen puntos de dirección con números de vivienda y nombres de calle asociados, junto con divisiones administrativas y códigos postales opcionales; por ejemplo, 380 New York St, Redlands, CA, 92373.

Una vista de localizador configurada con esta subcategoría limita los resultados a estos puntos de dirección altamente precisos, lo que le permite evitar la geocodificación con cualquier punto de dirección menos preciso si requiere una geocodificación de muy alta precisión.

Dirección

Las direcciones difieren de las direcciones de punto en el sentido de que el número de la casa de una dirección se interpola dentro de un rango de números. Los datos de referencia contienen líneas de centro de calles con rangos de números de casas, junto con las divisiones administrativas e información opcional del código postal, por ejemplo, 647 Haight St, San Francisco, CA, 94117.

La vista de localizador configurada con esta subcategoría limita los resultados a un resultado interpolado. Si desea limitar los resultados a las coincidencias que tengan como mínimo este grado de precisión, debe seleccionar tanto esta subcategoría como la categoría Dirección de punto.

Intersección

Una intersección es una dirección de una calle que consta de una intersección de calle junto con la ciudad e información opcional del estado y el código postal; por ejemplo, Redlands Blvd y New York St, Redlands, CA, 92373.

La vista de localizador configurada con esta subcategoría limita los resultados a las intersecciones, en lugar de a las direcciones completas que existen en una única calle.

Nombre de calle

Un nombre de calle es similar a una dirección de calle, pero sin el número de la casa. Contiene las líneas de centro de calles con nombres de calle asociados (sin rangos de direcciones con números), junto con las divisiones administrativas e información de código postal opcional; por ejemplo, W Olive Ave, Redlands, CA, 92373.

La vista de localizador configurada con esta subcategoría limita los resultados únicamente a los nombres de las calles. Si desea limitar los resultados a las coincidencias que tengan como mínimo este grado de precisión, debe seleccionar tanto esta subcategoría como las subcategorías Dirección de punto y Dirección.

Subdirección

Una subdirección es un subconjunto de una dirección de punto que representa a una ubicación de subconjunto de viviendas o edificios, por ejemplo, un apartamento, un piso, una planta o un edificio individual dentro de un complejo de edificios; por ejemplo, 3836 Emerald Ave, Suite C, La Verne, CA, 91750.

Una vista de localizador configurada con esta subcategoría limita los resultados a los puntos de subdirección que incluyen un número de casa, nombre de la calle y elementos de subdirección, junto con divisiones administrativas e información de código postal opcional, pero excluye los demás tipos de coincidencias de dirección.

Postal

Ninguna subcategoría

Una vista de localizador configurada con la categoría Postal devuelve cualquier tipo de coincidencia de código postal, incluidos el formato de 5 dígitos (por ejemplo, 92373) y otros formatos de código postal. Para limitar los resultados de la búsqueda a las coincidencias que tengan al menos este nivel de precisión, seleccione Postal y la categoría de nivel superior Dirección.

Lugar poblado

Vecindario

Un vecindario es una subsección de una ciudad y es más pequeña que un distrito y más grande que un sector.

Ciudad

Un localizador configurado con esta subcategoría limita los resultados únicamente a las ciudades; por ejemplo, la ciudad italiana de Venecia.

Subregión

Una subregión es un subconjunto de un estado o provincia, por ejemplo, un condado de los Estados Unidos; por ejemplo, Adams County en el estado de Wisconsin.

Region

Una región es una subsección de un país, normalmente un estado o provincia; por ejemplo, la provincia de Ontario en Canadá.

País

Un país es la mayor división administrativa y, con frecuencia, se usa en el mismo sentido que "nación"; por ejemplo, Japón.

Sector

Un sector es una división administrativa mayor que un bloque y menor que un vecindario; representa a una subdivisión de un vecindario o distrito, o bien a un conjunto de bloques.

Manzana

Un bloque es el área administrativa más pequeña de un país y representa a una subdivisión de un sector o vecindario, o bien una manzana designada dentro de una población.

Distrito

Un distrito es una división administrativa menor que una población y mayor que un vecindario; por ejemplo, un distrito municipal.

Área metropolitana

Un área metropolitana (abreviado "metro") es una aglomeración urbana compuesta por una gran ciudad y las ciudades más pequeñas a su alrededor; por ejemplo, el Gran Tokio.

Territorio

Un territorio es una división administrativa grande, más pequeña que un país y más grande que un estado o provincia; por ejemplo, el territorio del Yukón en Canadá.

Zona

Una zona es una categoría que representa un área administrativa no oficial que no pertenece a un país, por ejemplo, un área en disputa o un agrupamiento de otras zonas administrativas; por ejemplo, América Central.

Coordenadas

Si selecciona Coordenadas como los tipos de ubicaciones que desea buscar, puede afinar aún más los resultados de búsqueda de la vista de localizador seleccionando las categorías en las que desea buscar. Se describen en la tabla que aparece a continuación.

CategoríaDescripción

Longitud, latitud

Esta categoría corresponde a coordenadas geográficas (x,y). X se refiere a la longitud (coordenadas este-oeste) e Y se refiere a la latitud (coordenadas norte-sur). Las coordenadas se introducen y se devuelven como x,y.

Latitud, longitud

Esta categoría corresponde a coordenadas geográficas (x,y). X se refiere a la longitud (coordenadas este-oeste) e Y se refiere a la latitud (coordenadas norte-sur). Las coordenadas se introducen y se devuelven como y,x.

MGRS

Esta categoría corresponde a coordenadas del Sistema de Referencia de Cuadrícula Militar (MGRS).

USNG

Esta categoría corresponde a coordenadas del sistema de coordenadas de la Cuadrícula Nacional de Estados Unidos (USNG).

Lugares de interés

Si selecciona Lugares de interés como los tipos de ubicaciones que desea buscar, puede afinar aún más los resultados de búsqueda de la vista de localizador seleccionando las categorías en las que desea buscar. Se describen en la tabla que aparece a continuación.

CategoríaDescripción

Educación

Esta categoría corresponde a todos los tipos de instituciones educativas, tales como universidades, colegios de primaria y centros de formación profesional.

Alimentación

Esta categoría corresponde a restaurantes de todos los tipos.

Tiendas y servicios

Esta categoría corresponde a todos los tipos de negocios comerciales o de venta al por menor.

Aeropuerto

Esta categoría corresponde a los aeropuertos, designados por su nombre o por código de aeropuerto.

Requisitos para configurar sus propios localizadores

ArcGIS Online admite los localizadores ejecutados en ArcGIS Server 10.0 y posteriores como localizadores para la geobúsqueda. Cuando se utilizan para la geobúsqueda, los localizadores pueden ser internos o externos. Los localizadores internos solo funcionan para la geobúsqueda cuando el Map Viewer Classic u otros clientes de ArcGIS Online tienen acceso a dichos localizadores internos. Por ejemplo, si su organización comparte aplicaciones con el público, solo los usuarios que tengan acceso a sus localizadores internos podrán buscar lugares con dichas aplicaciones.

ArcGIS Online también admite los localizadores que se ejecutan en ArcGIS Server 10.1 y posteriores como geocodificadores para la geocodificación por lotes. A diferencia de la geobúsqueda, para la geocodificación por lotes se requieren localizadores externos que estén alojados fuera del firewall. Esto se debe a que ArcGIS Online necesita acceso a la operación geocodeAddresses del localizador para realizar la geocodificación por lotes. Si su localizador externo es seguro, primero debe crear un elemento de servicio seguro en ArcGIS Online que almacene las credenciales necesarias para acceder al localizador. A continuación, es posible configurar la dirección URL del servicio proporcionada por el elemento de servicio seguro como localizador.

Cuando configure su propio localizador para la geocodificación por lotes, debe proporcionar suficientes recursos de cálculo en el equipo para su localizador. ArcGIS Online envía muchas solicitudes concurrentes cuando realiza la geocodificación por lotes a fin de mejorar el rendimiento, de modo que sus propios localizadores deben tener recursos de cálculo suficientes para manejar solicitudes concurrentes sin afectar gravemente a los tiempos de procesamiento de las solicitudes.

ArcGIS Online admite los localizadores de un solo campo de ArcGIS Server 10.0 y posteriores. Los localizadores de ArcGIS Server 10.0 y los localizadores internos se pueden usar para la geobúsqueda, pero no para geocodificar por lotes. Para realizar la geocodificación por lotes, se necesitan los localizadores externos de ArcGIS Server 10.1 o posterior. Los localizadores internos solo funcionan para la geobúsqueda cuando Visor de mapas, Map Viewer Classic u otros clientes de ArcGIS Online tienen acceso a dichos localizadores internos. Por ejemplo, si su organización comparte aplicaciones con el público, solo los usuarios que tengan acceso a sus localizadores internos podrán buscar lugares con dichas aplicaciones. Actualmente, los elementos de servicios de seguros de ArcGIS Online no se admiten en ArcGIS Desktop. Para geocodificar por lotes, es necesario que su localizador esté alojado fuera de su firewall, de modo que ArcGIS Online pueda acceder a la operación geocodeAddresses de su localizador para realizar la geocodificación por lotes.

Enriquecer capa con información de direcciones

Cuando se publica una capa de entidades alojada desde un archivo (CSV), existe la opción de incluir información desde el proceso de geocodificación como parte de su capa de entidades alojada. El localizador genera esta información y se almacena en la capa de entidades alojada.

De forma predeterminada, solo se incluye la información de ubicación (las coordenadas x,y) en la capa de entidades alojada. Existen dos opciones para incluir información adicional en la capa de entidades alojada:

  • Incorporar cuatro campos para mostrar el grado de concordancia de las direcciones: se incluyen los campos y valores de status, score, match_addr y addr_type. Estos campos y valores se describen en la siguiente tabla.
  • Incorporar 50 campos para obtener información completa sobre ubicaciones: incluye todos los campos que aparecen en la siguiente tabla.

Tenga en cuenta que estos campos y valores adicionales aumentarán el tamaño de la capa de entidades alojada. El aumento de tamaño de la capa depende del número de registros en el archivo de entrada y de la opción que elija.

CampoDescripción

spatialReference

La referencia espacial de las coordenadas de ubicación coincidentes de salida tal y como se especifica en las propiedades wkid y latestWkid. El parámetro outSR de entrada determina la referencia espacial. Esto siempre se devuelve por defecto.

address

Se ha devuelto una dirección de concordancia completa para las solicitudes de geocodificación de findAddressCandidates y geocodeAddresses. Esto siempre se devuelve por defecto.

location

Las coordenadas del punto de la ubicación de coincidencia de la salida se especifican mediante las propiedades x e y. La referencia espacial de las coordenadas x e y se define mediante el campo spatialReference de salida. Siempre se devuelven de forma predeterminada solo para las solicitudes de geocodificación findAddressCandidates y geocodeAddresses. Consulte la descripción del parámetro locationType para obtener más información sobre cómo se relaciona el campo de salida de ubicación con los atributos de salida de X y Y.

ResultID

Solo se devuelven para las solicitudes de geocodeAddresses. Cada registro de una respuesta de geocodificación por lotes incluye un valor ResultID, que equivale al valor OBJECTID del registro de direcciones de entrada correspondiente. Puede utilizarse para unir los campos de salida en la respuesta a los atributos de la tabla de direcciones original.

Loc_name

El nombre del localizador utilizado para devolver un resultado de coincidencia concreto.

Nota:

El software de ArcGIS utiliza internamente el campo Loc_name y no está pensado para su uso por aplicaciones cliente.

Status

Indica si una solicitud de geocódigo en lote devuelve una coincidencia, un empate o una falta de coincidencia.

Entre los posibles valores se encuentran los siguientes:

  • M: concordar. La dirección devuelta coincide con la solicitud y es el candidato con la puntuación más alta.
  • T: igualar. La dirección devuelta coincide con la solicitud, pero tiene la misma puntuación que uno o más candidatos adicionales.
  • U: no concordar. Ninguna dirección coincide con la solicitud.

Score

Un número del 1 al 100 que indica el grado en que los tokens de entrada de una solicitud de geocodificación coinciden con los componentes de dirección en un registro candidato. Una puntuación de 100 representa una coincidencia perfecta, mientras que una puntuación más baja representa una menor precisión de la coincidencia. Score siempre se devuelve de forma predeterminada.

Match_addr

Dirección completa devuelta para la solicitud del geocódigo. El formato se basa en las normas de dirección del país en el que se encuentra la dirección.

LongLabel

Una versión más larga de Match_addr que contiene más información administrativa.

ShortLabel

Una versión abreviada de Match_addr.

Addr_type

El nivel de coincidencia para una solicitud de geocódigo. Los niveles de coincidencia admitidos varían en los distintos países.

Entre los posibles valores se encuentran los siguientes:

  • Subaddress: un subconjunto de PointAddress que representa la ubicación de la subdirección de una vivienda o un edificio, como un bloque de apartamentos, una planta o un edificio de un complejo. Los valores de campo UnitName, UnitType, LevelName, LevelType, BldgName y BldgType ayudan a distinguir las subdirecciones que se pueden asociar con las mismas PointAddress. Los datos de referencia se componen de entidades de punto con elementos de número de vivienda, nombre de calle y subdirección asociados, junto con divisiones administrativas y códigos postales opcionales; por ejemplo, 3836 Emerald Ave, Suite C, La Verne, CA, 91750.
  • PointAddress: una dirección postal basada en puntos que representan las ubicaciones de casas y edificios. Normalmente, es el nivel de coincidencia más exacto desde el punto de vista espacial. Los datos de referencia contienen puntos de dirección con números de vivienda y nombres de calle asociados, junto con divisiones administrativas y códigos postales opcionales. Los valores de salida X / Y y geometry de una coincidencia de PointAddress representan la ubicación de la entrada de la calle de la dirección, es decir, la ubicación empleada para las operaciones de generación de rutas. Los valores de DisplayX y DisplayY representan el tejado o la ubicación real de la dirección. Ejemplo: 380 New York St, Redlands, CA, 92373.
  • StreetAddress: una dirección postal que se diferencia de PointAddress porque el número de casa se interpola desde un rango de números. Los datos de referencia contienen líneas centrales de calles con rangos de números de casas, junto con las divisiones administrativas e información opcional del código postal, por ejemplo, 647 Haight St, San Francisco, CA, 94117.
  • StreetInt: una dirección postal consta de una intersección de calle junto con la ciudad e información opcional del estado y del código postal. Esto se deriva de los datos de referencia de StreetAddress, por ejemplo, Redlands Blvd & New York St, Redlands, CA, 92373.
  • StreetAddressExt: una coincidencia de dirección de calle interpolada que se devuelve si el parámetro matchOutOfRange=true y el número de casa de entrada superan el rango de número de casa en el segmento de calle coincidente.
  • DistanceMarker: una dirección de calle que representa la distancia lineal a lo largo de una calle, normalmente en kilómetros o millas, desde una ubicación de origen designada. Ejemplo: Carr 682 KM 4, Barceloneta, 00617.
  • StreetMidBlock: el punto medio estimado de un rango de números de casas a lo largo de un segmento de calle que se corresponde con una manzana de una ciudad. La ubicación devuelta para una coincidencia StreetMidBlock es más precisa que la de una coincidencia StreetName, pero menos precisa que una coincidencia StreetAddress. Actualmente solo funciona para EE. UU. Ejemplo: 100 Block of Grant Ave, Millville, New Jersey.
  • StreetName: similar a una dirección de calle, pero sin el número de casa. Los datos de referencia contienen líneas centrales de calles con nombres de calle asociados (sin rangos de direcciones numerados), junto con las divisiones administrativas y el código postal opcional, por ejemplo, W Olive Ave, Redlands, CA, 92373.
  • Locality: un nombre de lugar que representa un lugar poblado. El campo de salida Type proporciona información más detallada sobre el tipo de lugar poblado. Entre los posibles valores de Type para las coincidencias de Locality están Block, Sector, Neighborhood, District, City, MetroArea, County, State or Province, Territory, Country y Zone. Ejemplo: Bogotá, COL
  • PostalLoc: una combinación de código postal y nombre de ciudad. Los datos de referencia son normalmente una combinación de límites postales y límites administrativos (localidad), por ejemplo, 7132 Frauenkirchen.
  • PostalExt: un código postal con una extensión adicional, como el servicio postal de Estados Unidos ZIP+4. Los datos de referencia son los puntos de códigos postales con extensiones, por ejemplo, 90210-3841.
  • Postal: código postal. Los datos de referencia son los puntos de códigos postales, por ejemplo, 90210 USA.
  • POI: puntos de interés. Los datos de referencia constan de empresas, hitos y entidades geográficas, por ejemplo, Starbucks.
  • LatLong: un par de coordenadas x/y. El LatLong addr_type se devuelve cuando un par de coordenadas x/y, como 117.155579,32.703761, es la entrada de búsqueda.
  • XY: XY es la concordancia basada en la suposición de que la primera coordenada de la entrada es longitud y que la segunda es latitud.
  • YX: se devuelve YX como Addr_type para el candidato, en el que se supone que latitud es el primer número de la entrada, seguido de longitud.
  • MGRS: ubicación del Sistema de Referencia de Cuadrícula Militar (MGRS), por ejemplo46VFM5319397841.
  • USNG: una ubicación de la Cuadrícula Cartográfica Nacional de EE. UU. (USNG), por ejemplo15TXN29753883. Este valor de Addr_type solo se devuelve si el parámetro category se establece en USNG en una solicitud findAddressCandidates o geocodeAddresses.

Type

El tipo de entidad de los resultados devueltos por una búsqueda. El campo Type solo incluye un valor para candidatos con Addr_type = POI o Locality. Por ejemplo, para Starbucks, Type=Coffee Shop.

PlaceName

Nombre formal de un candidato de coincidencia de geocodificación, por ejemplo, Paris o Starbucks.

Place_addr

La dirección postal completa de un lugar, incluidas la calle, la ciudad y la región; por ejemplo, 275 Columbus Ave, New York, New York.

Phone

El número de teléfono principal de un lugar. Para otras búsquedas, como dirección, intersección y código postal, el campo está vacío, por ejemplo, Knott's Berry Farm, Phone=(714)220-5200.

URL

La URL del sitio web principal de un lugar. Para otras búsquedas, como dirección, intersección y código postal, el campo está vacío, por ejemplo, University of Georgia, URL =http://www.uga.edu/.

Rank

Un valor de número de punto flotante que indica la importancia de un resultado en relación con otros resultados con el mismo nombre. Por ejemplo, hay ciudades en Francia y Texas llamadas París. París, Francia, tiene una población mayor que París, Texas, por lo que su clasificación es mayor. Rank se utiliza para ordenar resultados de consultas ambiguas, tales como Lincoln, donde no hay ninguna información adicional (de estado) disponible. Los valores de Rank se basan en la población o en el tipo de entidad.

AddBldg

El nombre de un edificio, por ejemplo, Empire State Building.

AddNum

El valor alfanumérico que representa la porción de una dirección conocida habitualmente como número de vivienda o número de edificio, por ejemplo, en la dirección 380 New York Street, AddNum = 380.

Este valor se obtiene únicamente de las coincidencias PointAddress y StreetAddress.

AddNumFrom

Un valor que representa el número de comienzo de un rango de direcciones de calles. Hace relación a la dirección de digitalización de entidades y no siempre es el menor número del rango. Este valor se proporciona para los resultados StreetAddress.

AddNumTo

Un valor que representa el número final de un rango de direcciones de calles. Hace relación a la dirección de digitalización de entidades y no siempre es el mayor número del rango. Este valor se proporciona para los resultados StreetAddress.

AddRange

El rango completo de números de la calle para el segmento de calle donde está una dirección, en el formato AddNumFrom-AddNumTo. Por ejemplo, el valor AddRange de la dirección de calle 123 Main St puede ser 101-199.

Side

El lado de la calle donde reside una dirección con respecto a la dirección de digitalización de entidades. Este valor no es relativo a la dirección de viaje a lo largo de la calle. Los valores posibles son R (derecha) y L (izquierda).

StPreDir

Un elemento de dirección que define la dirección de una calle y se sitúa antes del nombre de calle principal, por ejemplo, North en North Main Street.

StPreType

Un elemento de dirección que define el tipo principal de una calle, por ejemplo, Avenida en Avenida Central o el término en francés Rue en Rue Lapin.

StName

En elemento de dirección que define el nombre principal de una calle, por ejemplo, Main en North Main Street.

StType

En elemento de dirección que define el elemento final del nombre de una calle, por ejemplo, "Street" en Main Street.

StDir

Un elemento de dirección que define la dirección de una calle, que se sitúa después del nombre de calle principal, por ejemplo, North en Main Street North.

BldgName

El nombre o número de una subunidad de edificio. Por ejemplo, A en building A.

BldgType

La clasificación de una subunidad de edificio. Ejemplos de lo anterior son edificio, hangar, torre.

LevelType

La clasificación de una subunidad de planta. Ejemplos de lo anterior son planta, nivel, departamento, ala.

LevelName

El nombre o número de una subunidad de planta. Por ejemplo, 3 en level 3.

UnitType

La clasificación de una subunidad de unidad. Ejemplos de lo anterior son unidad, apartamento, piso, oficina, suite.

UnitName

El nombre o número de una subunidad de unidad. Por ejemplo, 2B en apartment 2B.

SubAddr

El valor completo de subunidad para un candidato con Addr_type=Subaddress, que incluye <subunit type> + <subunit name>. Por ejemplo, si el candidato de subdirección es un bloque de apartamentos, SubAddr = UnitType + UnitName. Ejemplo: Apt 4B

StAddr

La dirección de calle de un lugar, sin ciudad ni región; por ejemplo, 275 Columbus Ave.

Block

El nombre de la división administrativa a nivel de manzana para un candidato. Block es el área administrativa más pequeña de un país. Se puede describir como una subdivisión de sector o vecindario o un bloque de ciudad con nombre. No se utiliza normalmente.

Sector

El nombre de la división administrativa a nivel de sector para un candidato. Sector es una subdivisión de un vecindario o distrito, o representa un conjunto de manzanas. No se utiliza normalmente.

Nbrhd

El nombre de la división administrativa a nivel de vecindario para un candidato. Nbhrhd es una subsección de una ciudad o distrito.

District

El nombre de la división administrativa a nivel de distrito para un candidato. Subdivisión de ciudad.

City

El nombre de la división administrativa a nivel de ciudad para un candidato. City es una subdivisión de una subregión o región.

MetroArea

El nombre de la división administrativa a nivel de área metropolitana para un candidato. Un área urbana compuesta por una gran ciudad y las ciudades más pequeñas a su alrededor. Puede intersecar varias subregiones o regiones. Un ejemplo es Kolkata Metropolitan Area en India.

Subregion

El nombre de la división administrativa a nivel de subregión para un candidato. Subregion es una subdivisión de una región.

Region

El nombre de la división administrativa a nivel de región para un candidato. Subdivisión de un país o territorio. Normalmente, la mayor área administrativa de un país si no se utiliza la división administrativa Territory.

RegionAbbr

El nombre abreviado de una región. El valor RegionAbbr de California es CA.

Territory

El nombre de la división administrativa a nivel de territorio para un candidato. Subdivisión de un país. No se utiliza normalmente. La Sudeste macroregion de Brasil, que engloba los estados de Espíritu Santo, Minas Gerais, Río de Janeiro y San Paulo, es un ejemplo.

Postal

Un elemento de dirección alfanumérico que define el código postal principal, por ejemplo, V7M 2B4 en el caso de un código postal canadiense y 92374 para un código postal de Estados Unidos.

PostalExt

Un elemento de dirección alfanumérico que define la extensión del código postal, por ejemplo, 8100 en el código postal de Estados Unidos 92373-8110.

Country

Un código de tres caracteres para un país, por ejemplo, Canadá = CAN. En Cobertura de datos, encontrará una lista de los países y códigos compatibles. findAddressCandidates y geocodeAddresses devuelven este campo.

CountryCode

Un código de tres caracteres para un país, por ejemplo, Canadá = CAN. En Cobertura de datos, encontrará una lista de los países y códigos compatibles. Este campo es el mismo que el campo de salida Country; la diferencia es que solo reverseGeocode lo devuelve.

CntryName

El nombre completo del país para un candidato de dirección; por ejemplo, "日本" (Japón). El nombre puede estar en el mismo idioma que la dirección de entrada o en el idioma especificado por el parámetro langCode de la solicitud. Si el nombre completo del país no está disponible en el idioma especificado, se utiliza el idioma principal del país en el que se encuentra el candidato de dirección. La información sobre los idiomas compatibles por país está disponible en Cobertura de datos. findAddressCandidates, geocodeAddresses y reverseGeocode devuelven este campo.

LangCode

Un código de idioma de tres caracteres, que representa el idioma de la dirección, por ejemplo, ENG = English.

Distance

La distancia física en metros desde un candidato a una ubicación especificada. El valor de salida Distance se calcula para cada candidato cuando el parámetro de entrada Location se aprueba en una solicitud mediante la operación findAddressCandidates. Si no se pasa el parámetro Location en una consulta, el valor de Distance es cero.

X

La coordenada x principal de una dirección devuelta por el ArcGIS World Geocoding Service en la referencia espacial WGS84 (WKID 4326).

Y

La coordenada y principal de una dirección devuelta por el ArcGIS World Geocoding Service en la referencia espacial WGS84 (WKID 4326).

DisplayX

La coordenada x de visualización de una dirección devuelta por el ArcGIS World Geocoding Service en la referencia espacial WGS84 (WKID 4326). Para la mayoría de los tipos de coincidencias, los valores X y DisplayX son los mismos. Para las coincidencias de Addr_type PointAddress y Subaddress específicamente, los valores pueden ser diferentes. En general, para las coincidencias PointAddress y Subaddress, DisplayX representa el valor de la coordenada x del tejado del edificio o centroide de parcela para la dirección, mientras que el valor X representa la coordenada x de la ubicación del lado de la calle para la dirección. No obstante, existen excepciones. Algunas fuentes de datos de direcciones utilizadas por ArcGIS World Geocoding Service solo proporcionan la ubicación del tejado de las entidades PointAddress y Subaddress; por otro lado, para algunas entidades PointAddress y Subaddress, solo está disponible la ubicación del lado de la calle. Para estos casos, los valores X y DisplayX son equivalentes.

DisplayY

La coordenada y de visualización de una dirección devuelta por el ArcGIS World Geocoding Service en la referencia espacial WGS84 (WKID 4326). Para la mayoría de los tipos de coincidencias, los valores Y y DisplayY son los mismos. Para las coincidencias de Addr_type PointAddress y Subaddress específicamente, los valores pueden ser diferentes. En general, para las coincidencias PointAddress y Subaddress, DisplayY representa el valor de la coordenada y del tejado del edificio o centroide de parcela para la dirección, mientras que el valor Y representa la coordenada y de la ubicación del lado de la calle para la dirección. No obstante, existen excepciones. Algunas fuentes de datos de direcciones utilizadas por ArcGIS World Geocoding Service solo proporcionan la ubicación del tejado de las entidades PointAddress y Subaddress; por otro lado, para algunas entidades PointAddress y Subaddress, solo está disponible la ubicación del lado de la calle. Para estos casos, los valores Y y DisplayY son equivalentes.

Xmin

La coordenada x mínima de la extensión de visualización de una entidad devuelta por ArcGIS World Geocoding Service. Los valores de Xmin, Xmax, Ymin y Ymax se combinan para establecer la extensión de mapa a fin de mostrar un resultado de geocodificación. Las coordenadas de extensión usan la referencia espacial WGS84.

Xmax

La coordenada x máxima de la extensión de visualización de una entidad devuelta por ArcGIS World Geocoding Service. Los valores de Xmin, Xmax, Ymin y Ymax se combinan para establecer la extensión de mapa a fin de mostrar un resultado de geocodificación. Las coordenadas de extensión usan la referencia espacial WGS84.

Ymin

La coordenada y mínima de la extensión de visualización de una entidad devuelta por ArcGIS World Geocoding Service. Los valores de Xmin, Xmax, Ymin y Ymax se combinan para establecer la extensión de mapa a fin de mostrar un resultado de geocodificación. Las coordenadas de extensión usan la referencia espacial WGS84.

Ymax

La coordenada y máxima de la extensión de visualización de una entidad devuelta por ArcGIS World Geocoding Service. Los valores de Xmin, Xmax, Ymin y Ymax se combinan para establecer la extensión de mapa a fin de mostrar un resultado de geocodificación. Las coordenadas de extensión usan la referencia espacial WGS84.

ExInfo

Un conjunto de cadenas de la entrada que no coincidían con ninguna parte de una dirección y que se utilizaron para puntuar o penalizar el resultado.

extent

El rectángulo mínimo de delimitación de la entidad de coincidencia de salida, según se especifica mediante las propiedades xmin, ymin, xmax e ymax. La referencia espacial de las coordenadas x e y se define mediante el campo spatialReference de salida. Siempre se devuelve de forma predeterminada únicamente para las solicitudes de geocodificación findAddressCandidates.