L'endpoint LATLG convertit un identifiant de voie et un numéro de rue en coordonnées géographiques (latitude et longitude).
Documentation Géocodage associée :
- API - Description - Géocodage inversé - SINGLE
- Introduction Géocodage / Géocodage inversé
- Géocodage et Géocodage inversé — Documentation Swagger
Requête GET
Endpoint
https://{SERVER_ADDRESS}/LATLG/?IDVoie={STREET_ID}&Num={NUM}&Pays={COUNTRY_CODE}&Taille={LENGTH}&Instance={VALUE}&Licence={LICENCE_CODE}
Remplacez les valeurs entre accolades par vos propres informations :
| Paramètre | Description | Obligatoire/Optionnel |
|---|---|---|
| SERVER_ADDRESS | Adresse du serveur DQE utilisée pour traiter la requête. | Obligatoire |
| Licence | Votre code de licence DQE. | Obligatoire |
| IDVoie | Identifiant unique de la voie renvoyé par la commande ADR. | Obligatoire |
| Num | Numéro de rue. | Obligatoire |
| Pays | Code pays ISO à 3 lettres. | Obligatoire |
| Taille | Longueur maximale de l'adresse. Valeur par défaut : 38. |
Optionnel |
| Instance | Valeur personnalisée renvoyée telle quelle dans la réponse. | Optionnel |
Requête POST
Endpoint
https://{SERVER_ADDRESS}/LATLG/
Ajoutez les paramètres suivants dans le corps de la requête au format x-www-form-urlencoded.
| Paramètre | Description | Obligatoire/Optionnel |
|---|---|---|
| Licence | Votre code de licence DQE. | Obligatoire |
| IDVoie | Identifiant unique de la voie renvoyé par la commande ADR. | Obligatoire |
| Num | Numéro de rue. | Obligatoire |
| Pays | Code pays ISO à 3 lettres. | Obligatoire |
| Taille | Longueur maximale de l'adresse. Valeur par défaut : 38. |
Optionnel |
| Instance | Valeur personnalisée renvoyée telle quelle dans la réponse. | Optionnel |
Réponse
Réponse de succès
La réponse JSON est un dictionnaire dont les clés sont numérotées de 1 à n. Chaque élément contient les clés suivantes :
| Clé | Description | Tous pays | Format |
|---|---|---|---|
| Latitude | Latitude de l'adresse. | Oui | Décimal |
| Longitude | Longitude de l'adresse. | Oui | Décimal |
| CodeQualiteGeo | Code du type de qualité de géocodage. | Non | Chaîne |
| LibelleQualiteGeo | Libellé du type de qualité de géocodage. | Non | Chaîne |
Codes de qualité de géocodage :
| CodeQualiteGeo | LibelleQualiteGeo | Description |
|---|---|---|
1 |
ENTREE | Point d'accès principal à une enceinte ouverte ou fermée, un groupe de bâtiments, ou une parcelle de terrain. |
2 |
BATIMENT | Bâtiment ou partie de bâtiment. |
3 |
ESCALIERS | Cage d'escalier, normalement à l'intérieur d'un bâtiment. |
4 |
LOGEMENT | Logement ou pièce à l'intérieur d'un bâtiment. |
5 |
PARCELLE CADASTRALE | Parcelle cadastrale. |
6 |
SEGMENT DE VOIE | Position dérivée du segment de voie de rattachement. |
7 |
POINT D ACCESS TECHNIQUE | Point d'accès technique. |
8 |
POINT DELIVRANCE POSTALE | Point de remise postale, tel qu'une boîte aux lettres. |
9 |
ZONE D ADRESSAGE | Point placé dans la localité rattachée. |
10 |
CENTRE VILLE | Centre-ville. |
00 |
CENTRE DE LA VOIE | Point au centre de la voie. |
90 |
A CONTROLER | À contrôler. |
99 |
NON PRESENTE | Non disponible. |
Exemple :
{
"1": {
"Latitude": "48.836069",
"Longitude": "2.235501",
"CodeQualiteGeo": "1",
"LibelleQualiteGeo": "ENTREE"
}
}
Réponse d'erreur
| Type d'erreur | Réponse |
|---|---|
Paramètre Licence manquant, vide ou incorrect |
Renvoie une latitude et une longitude égales à 0.00. |
Paramètre IDVoie manquant |
500 Internal Server Error |
Paramètre Num manquant |
500 Internal Server Error |
Paramètre Pays manquant |
500 Internal Server Error |
| Erreur de saisie dans un paramètre | 500 Internal Server Error |
Exemple d'erreur de licence :
{
"1": {
"Latitude": "0.00",
"Longitude": "0.00"
}
}
Voir aussi
Associé à