El endpoint LATLG convierte un identificador de calle y un número de calle en coordenadas geográficas (latitud y longitud).
Documentación relacionada de Geocoding:
- API - Description - Reverse Geocoding - SINGLE
- Geocoding / Reverse Geo introduction
- Geocoding and Reverse Geocoding — Swagger documentation
Solicitud GET
Endpoint
https://{SERVER_ADDRESS}/LATLG/?IDVoie={STREET_ID}&Num={NUM}&Pays={COUNTRY_CODE}&Taille={LENGTH}&Instance={VALUE}&Licence={LICENCE_CODE}
Sustituya los valores entre llaves por su propia información:
| Parámetro | Descripción | Obligatorio/Opcional |
|---|---|---|
| SERVER_ADDRESS | Dirección del servidor DQE utilizada para procesar la solicitud. | Obligatorio |
| Licence | Su código de licencia DQE. | Obligatorio |
| IDVoie | Identificador único de la calle devuelto por el comando ADR. | Obligatorio |
| Num | Número de la calle. | Obligatorio |
| Pays | Código de país ISO de 3 letras. | Obligatorio |
| Taille | Longitud máxima de la dirección. Valor predeterminado: 38. |
Opcional |
| Instance | Valor personalizado devuelto tal cual en la respuesta. | Opcional |
Solicitud POST
Endpoint
https://{SERVER_ADDRESS}/LATLG/
Añada los siguientes parámetros en el cuerpo de la solicitud utilizando x-www-form-urlencoded.
| Parámetro | Descripción | Obligatorio/Opcional |
|---|---|---|
| Licence | Su código de licencia DQE. | Obligatorio |
| IDVoie | Identificador único de la calle devuelto por el comando ADR. | Obligatorio |
| Num | Número de la calle. | Obligatorio |
| Pays | Código de país ISO de 3 letras. | Obligatorio |
| Taille | Longitud máxima de la dirección. Valor predeterminado: 38. |
Opcional |
| Instance | Valor personalizado devuelto tal cual en la respuesta. | Opcional |
Respuesta
Respuesta correcta
La respuesta JSON es un diccionario cuyas claves están numeradas de 1 a n. Cada elemento contiene las siguientes claves:
| Clave | Descripción | Todos los países | Formato |
|---|---|---|---|
| Latitude | Latitud de la dirección. | Sí | Decimal |
| Longitude | Longitud de la dirección. | Sí | Decimal |
| CodeQualiteGeo | Código del tipo de calidad de geocodificación. | No | String |
| LibelleQualiteGeo | Etiqueta del tipo de calidad de geocodificación. | No | String |
Códigos de calidad de geocodificación:
| CodeQualiteGeo | LibelleQualiteGeo | Descripción |
|---|---|---|
1 |
ENTREE | Punto de acceso principal a un recinto abierto o cerrado, un conjunto de edificios o un terreno. |
2 |
BATIMENT | Edificio o parte de un edificio. |
3 |
ESCALIERS | Hueco de escalera, normalmente dentro de un edificio. |
4 |
LOGEMENT | Vivienda o habitación dentro de un edificio. |
5 |
PARCELLE CADASTRALE | Parcela catastral. |
6 |
SEGMENT DE VOIE | Posición derivada del segmento de calle de conexión. |
7 |
POINT D ACCESS TECHNIQUE | Punto de acceso técnico. |
8 |
POINT DELIVRANCE POSTALE | Punto de entrega postal, como un buzón. |
9 |
ZONE D ADRESSAGE | Punto situado en la localidad dependiente. |
10 |
CENTRE VILLE | Centro de la ciudad. |
00 |
CENTRE DE LA VOIE | Punto en el centro de la calle. |
90 |
A CONTROLER | Por verificar. |
99 |
NON PRESENTE | No disponible. |
Ejemplo:
{
"1": {
"Latitude": "48.836069",
"Longitude": "2.235501",
"CodeQualiteGeo": "1",
"LibelleQualiteGeo": "ENTREE"
}
}
Respuesta de error
| Tipo de error | Respuesta |
|---|---|
Parámetro Licence faltante, vacío o incorrecto |
Devuelve latitud y longitud iguales a 0.00. |
Parámetro IDVoie faltante |
500 Internal Server Error |
Parámetro Num faltante |
500 Internal Server Error |
Parámetro Pays faltante |
500 Internal Server Error |
| Error tipográfico en el parámetro | 500 Internal Server Error |
Ejemplo de error de licencia:
{
"1": {
"Latitude": "0.00",
"Longitude": "0.00"
}
}
Véase también
Relacionada con