Solicitud POST de geocodificación inversa
La solicitud POST le permite enviar una coordenada de entrada o una lista de coordenadas para un procesamiento por lotes. Opcionalmente también se puede especificar un código de país, un sistema de referencia de coordenadas y las preferencias de comparación. Se devuelve una respuesta que incluye una lista de candidatos con los datos de dirección relacionados y la información de cruce. Las opciones de preferencia de una solicitud POST son el conjunto completo de las opciones disponibles.
URI base
http://<server>:<port>/rest/GlobalGeocode/reverseGeocode[.content type]Donde:
[.content type] indica que el tipo de contenido especificado se usará de manera predeterminada. Opcional.
- json
- El tipo de contenido predeterminado es JSON, salvo que la negociación de contenido HTTP lo sustituya
- xml
- El tipo de contenido predeterminado es XML, salvo que la negociación de contenido HTTP lo sustituya
Parámetros de la solicitud
La solicitud POST consta de los siguientes parámetros de entrada:
- : Las coordenadas de entrada que se van a someter a geocodificación inversa. Obligatorio.
- : Las opciones de comparación. Opcional.
| Nombre | Tipo | Descripción |
|---|---|---|
| un objeto de matriz que contiene un objeto geométrico y una cadena de código del país: | ||
| country | Cadena | Indica el país para buscar el resultado de la geocodificación inversa, especificado mediante el uso de un código de país ISO de 3 letras. Opcional. Para conocer los códigos de los países, consulte Códigos de país ISO 3166-1. |
| Objeto , consiste en los siguientes elementos: | ||
| coordinates | Double | Especifica las coordenadas de entrada x, y, donde x=longitud, y = latitud. Por ejemplo: [ -105.25175, 40.024494 ] |
| type | Cadena | Indica el tipo de entidad geográfica que representan las coordenadas de entrada.
|
| crs | Cadena | Indica el sistema de referencia de coordenadas utilizado para las coordenadas de entrada. El formato debe ser el del código EPSG (European Petroleum Survey Group) o el código SRID. Opción predeterminada = EPSG:4326. Especifique el sistema de referencia de coordenadas en el formato codespace:code. |
| Objeto , consiste en los siguientes elementos. Nota: Solo los siguientes elementos en el objeto preferencias se pueden aplicar al servicio Reverse Geocode. Nota: Para anular el valor predeterminado de un elemento preferences para un país específico, especifique el par de clave/valor en el objeto customPreferences, con la constante de clave precedida por el código del país de 3 caracteres ISO-3166 más un punto. Por ejemplo: DEU.streetOffset. |
||
| distance | Double | Establece el radio en el cual el servicio de geocodificación inversa busca una coincidencia con las coordenadas de entrada. La unidad de medida se especifica por medio de . Valor predeterminado = 150 metros. Valor máximo = 5280 pies (1 milla) o 1609 metros. |
| distanceUnits | Cadena | Especifica la unidad de medida para la distancia de búsqueda. Una de las siguientes:
|
| clientLocale | Cadena | Este campo se utiliza para un país que tiene varios idiomas, a fin de determinar el orden preferido para los candidatos de idioma. La configuración regional se debe especificar en el formato “cc_CC”, donde “cc” es el idioma y “CC” es el código ISO 3166-1 Alpha-2, como: en-US, fr_CA o fr_FR. Por ejemplo, Egipto admite inglés y árabe. El campo clientLocale se puede definir con el inglés primero (en-EN) o el árabe primero (ar-EG). Nota: Para acceder a una lista de códigos de países ISO Alpha-2, consulte Códigos de país ISO 3166-1. |
POST: clientCoordSysName |
Cadena | Especifica el sistema de coordenadas al que se desea convertir la geometría. El formato debe ser el del código EPSG (European Petroleum Survey Group) o el código SRID. Opción predeterminada = EPSG:4326. Especifique el sistema de referencia de coordenadas en el formato |
| streetOffset | Double | La distancia de desplazamiento desde los segmentos de calle. La distancia se expresa en las unidades que haya especificado en la preferencia streetOffsetUnits. Valor predeterminado = 7 metros. La distancia de desplazamiento se utiliza en la geocodificación de nivel de calle para evitar que el código geográfico esté en el medio de una calle. Compensa el hecho de que la geocodificación de nivel de calle devuelve un punto de latitud y longitud en el centro de la calle donde se ubica la dirección. Por ejemplo, un desplazamiento de 50 pies (15,24 m) significa que el código geográfico representará un punto ubicado a 50 pies (15,24 m) del centro de la calle. La distancia se calcula de forma perpendicular a la parte del segmento de calle correspondiente a la dirección. El desplazamiento también se utiliza para evitar que a las direcciones de lados opuestos de la calle se les asigne el mismo punto. |
| streetOffsetUnits | Cadena | Unidad de medida para el desplazamiento de calle. Tiene uno de los siguientes valores: Pies, Metros (valor predeterminado). |
| cornerOffset | Double | Distancia para desplazar los puntos finales de calle en la comparación a nivel de calle. La distancia se expresa en las unidades que haya especificado en la preferencia cornerOffsetUnits. Este valor se usa para evitar que las direcciones en las esquinas de las calles reciban el mismo código geográfico que la intersección. Define la posición de desplazamiento del punto geocodificado, en relación con la esquina. Valor predeterminado = 7 metros. El siguiente diagrama compara los puntos finales de una calle con los puntos finales de desplazamiento.  |
| cornerOffsetUnits | Cadena | Unidad de medida para el desplazamiento de calle. Tiene uno de los siguientes valores: Pies, Metros (valor predeterminado). |
| customPreferences | Map<String key, String value> | Especifica las preferencias de entrada específicas del país. Este objeto se puede usar para especificar:
Para anular el valor predeterminado de un país específico, preceda la constante de clave con el código del país ISO-3 más un punto, y luego especifique el valor. Por ejemplo, en una solicitud XML, la entrada de una anulación de un país se vería así: Las opciones de entrada personalizadas del país se encuentran disponibles para los siguientes países:
|