API Géocodage — Obtenir les coordonnées GPS

API Geocoding

L'endpoint LATLG convertit un identifiant de voie et un numéro de rue en coordonnées géographiques (latitude et longitude).

Documentation Geocoding associée :

/LATLG/

Aller à Réponse Exemple Erreurs ▶ Tester l'API

Requête

Les méthodes GET et POST sont toutes deux prises en charge.

{SERVER_ADDRESS} et {LICENCE_CODE} vous sont fournis par DQE à la création de votre compte. Contactez votre chargé de compte DQE pour obtenir ces identifiants.

GET POST

GEThttps://{SERVER_ADDRESS}/LATLG/?IDVoie={STREET_ID}&Num={NUM}&Pays={COUNTRY_CODE}&Taille={LENGTH}&Instance={VALUE}&Licence={LICENCE_CODE}

Exemples de code

Adresse valide

cURL JavaScript Python PHP Node.js Java C# Go

curl "https://{SERVER_ADDRESS}/LATLG/?IDVoie=1749869&Num=104&Pays=FRA&Licence={LICENCE_CODE}"

fetch("https://{SERVER_ADDRESS}/LATLG/?" + new URLSearchParams({
  IDVoie: "1749869",
  Num: "104",
  Pays: "FRA",
  Licence: "{LICENCE_CODE}"
}))
  .then(r => r.json())
  .then(data => console.log(data));

import requests

response = requests.get(
    "https://{SERVER_ADDRESS}/LATLG/",
    params={
        "IDVoie": "1749869",
        "Num": "104",
        "Pays": "FRA",
        "Licence": "{LICENCE_CODE}",
    },
)
print(response.json())

<?php
$params = http_build_query([
    'IDVoie'  => '1749869',
    'Num'     => '104',
    'Pays'    => 'FRA',
    'Licence' => '{LICENCE_CODE}',
]);

$ch = curl_init("https://{SERVER_ADDRESS}/LATLG/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

const axios = require('axios');

axios.get('https://{SERVER_ADDRESS}/LATLG/', {
  params: {
    IDVoie: '1749869',
    Num: '104',
    Pays: 'FRA',
    Licence: '{LICENCE_CODE}'
  }
})
  .then(response => console.log(response.data));

HttpClient client = HttpClient.newHttpClient();

String url = "https://{SERVER_ADDRESS}/LATLG/"
    + "?IDVoie=1749869&Num=104&Pays=FRA&Licence={LICENCE_CODE}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using var client = new HttpClient();

var url = "https://{SERVER_ADDRESS}/LATLG/" +
    "?IDVoie=1749869&Num=104&Pays=FRA&Licence={LICENCE_CODE}";

var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://{SERVER_ADDRESS}/LATLG/" +
        "?IDVoie=1749869&Num=104&Pays=FRA&Licence={LICENCE_CODE}"

    resp, err := http.Get(url)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Remplacez les valeurs entre accolades par vos propres informations :

Paramètre	Description	Obl / Opt
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 sur 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

POSThttps://{SERVER_ADDRESS}/LATLG/

Envoyez tous les paramètres dans le corps de la requête au format Content-Type: application/x-www-form-urlencoded. L'adresse du serveur reste dans l'URL.

Exemples de code

Adresse valide

cURL JavaScript Python PHP Node.js Java C# Go

curl -X POST "https://{SERVER_ADDRESS}/LATLG/" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "Licence={LICENCE_CODE}" \
  -d "IDVoie=1749869" \
  -d "Num=104" \
  -d "Pays=FRA"

fetch("https://{SERVER_ADDRESS}/LATLG/", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({
    Licence: "{LICENCE_CODE}",
    IDVoie: "1749869",
    Num: "104",
    Pays: "FRA"
  })
})
  .then(r => r.json())
  .then(data => console.log(data));

import requests

response = requests.post(
    "https://{SERVER_ADDRESS}/LATLG/",
    data={
        "Licence": "{LICENCE_CODE}",
        "IDVoie": "1749869",
        "Num": "104",
        "Pays": "FRA",
    },
)
print(response.json())

<?php
$ch = curl_init("https://{SERVER_ADDRESS}/LATLG/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'Licence' => '{LICENCE_CODE}',
    'IDVoie'  => '1749869',
    'Num'     => '104',
    'Pays'    => 'FRA',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

const axios = require('axios');
const qs = require('querystring');

axios.post('https://{SERVER_ADDRESS}/LATLG/', qs.stringify({
  Licence: '{LICENCE_CODE}',
  IDVoie: '1749869',
  Num: '104',
  Pays: 'FRA'
}))
  .then(response => console.log(response.data));

HttpClient client = HttpClient.newHttpClient();

String form = "Licence={LICENCE_CODE}&IDVoie=1749869&Num=104&Pays=FRA";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://{SERVER_ADDRESS}/LATLG/"))
    .header("Content-Type", "application/x-www-form-urlencoded")
    .POST(HttpRequest.BodyPublishers.ofString(form))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using var client = new HttpClient();

var form = new Dictionary<string, string> {
    ["Licence"] = "{LICENCE_CODE}",
    ["IDVoie"]  = "1749869",
    ["Num"]     = "104",
    ["Pays"]    = "FRA"
};

var response = await client.PostAsync(
    "https://{SERVER_ADDRESS}/LATLG/",
    new FormUrlEncodedContent(form));

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    form := url.Values{}
    form.Set("Licence", "{LICENCE_CODE}")
    form.Set("IDVoie", "1749869")
    form.Set("Num", "104")
    form.Set("Pays", "FRA")

    resp, err := http.PostForm("https://{SERVER_ADDRESS}/LATLG/", form)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Ajoutez les paramètres suivants dans le corps de la requête au format x-www-form-urlencoded.

Paramètre	Description	Obl / Opt
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 sur 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

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	Decimal
Longitude	Longitude de l'adresse.	Oui	Decimal
CodeQualiteGeo	Code du type de qualité de géocodage.	Non	String
LibelleQualiteGeo	Libellé du type de qualité de géocodage.	Non	String

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, comme une boîte aux lettres.
9	ZONE D ADRESSAGE	Point placé dans la localité de rattachement.
10	CENTRE VILLE	Centre-ville.
00	CENTRE DE LA VOIE	Point au centre de la voie.
90	A CONTROLER	À vérifier.
99	NON PRESENTE	Non disponible.

Exemple de réponse

{
  "1": {
    "Latitude":          "48.836069",
    "Longitude":         "2.235501",
    "CodeQualiteGeo":    "1",
    "LibelleQualiteGeo": "ENTREE"
  }
}

Erreurs

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 frappe dans le paramètre	`500 Internal Server Error`

Exemple d'erreur de licence :

{
  "1": {
    "Latitude":  "0.00",
    "Longitude": "0.00"
  }
}

Tester l'API

Cliquez sur le bouton ci-dessous pour tester cet endpoint en direct dans votre navigateur.

Ouvrir la console

Voir aussi

API Response Codes — Complete Reference

API Géocodage — Obtenir les coordonnées GPS

/LATLG/

Requête

Exemples de code

Exemples de code

Réponse

Codes de qualité de géocodage

Exemple de réponse

Erreurs

Tester l'API

Voir aussi

Cet article vous a-t-il été utile ?

Article précédent

Article suivant