Geocoding API
The LATLG endpoint converts a street identifier and street number into geographic coordinates (latitude and longitude).
Related Geocoding documentation:
/LATLG/
Request
Both GET and POST are supported.
{SERVER_ADDRESS} and {LICENCE_CODE}
are provided by DQE upon account creation. Contact your DQE account
manager to obtain these credentials.
GEThttps://{SERVER_ADDRESS}/LATLG/?IDVoie={STREET_ID}&Num={NUM}&Pays={COUNTRY_CODE}&Taille={LENGTH}&Instance={VALUE}&Licence={LICENCE_CODE}
Code examples
Valid address
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))
}
Replace the values in braces with your own information:
| Parameter | Description | Mand / Opt |
|---|---|---|
| SERVER_ADDRESS | DQE server address used to process the request. | Mandatory |
| Licence | Your DQE licence code. | Mandatory |
| IDVoie | Unique street identifier returned by the ADR command. | Mandatory |
| Num | Street number. | Mandatory |
| Pays | ISO 3-letter country code. | Mandatory |
| Taille |
Maximum address length. Default value: 38.
|
Optional |
| Instance | Custom value returned as-is in the response. | Optional |
POSThttps://{SERVER_ADDRESS}/LATLG/
Send all parameters in the request body using
Content-Type: application/x-www-form-urlencoded.
The server address remains in the URL.
Code examples
Valid address
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))
}
Add the following parameters in the request body using
x-www-form-urlencoded.
| Parameter | Description | Mand / Opt |
|---|---|---|
| Licence | Your DQE licence code. | Mandatory |
| IDVoie | Unique street identifier returned by the ADR command. | Mandatory |
| Num | Street number. | Mandatory |
| Pays | ISO 3-letter country code. | Mandatory |
| Taille |
Maximum address length. Default value: 38.
|
Optional |
| Instance | Custom value returned as-is in the response. | Optional |
Response
The JSON response is a dictionary whose keys are numbered from
1
to n. Each element contains the following keys:
| Key | Description | All countries | Format |
|---|---|---|---|
| Latitude | Latitude of the address. | Yes | Decimal |
| Longitude | Longitude of the address. | Yes | Decimal |
| CodeQualiteGeo | Code of the geocoding quality type. | No | String |
| LibelleQualiteGeo | Label of the geocoding quality type. | No | String |
Geocoding quality codes
| CodeQualiteGeo | LibelleQualiteGeo | Description |
|---|---|---|
| 1 | ENTREE | Main access point to an open or closed enclosure, a group of buildings, or a piece of land. |
| 2 | BATIMENT | Building or part of a building. |
| 3 | ESCALIERS | Stairwell, normally inside a building. |
| 4 | LOGEMENT | Housing or room inside a building. |
| 5 | PARCELLE CADASTRALE | Cadastral parcel. |
| 6 | SEGMENT DE VOIE | Position derived from the connecting street segment. |
| 7 | POINT D ACCESS TECHNIQUE | Technical access point. |
| 8 | POINT DELIVRANCE POSTALE | Postal delivery point, such as a mailbox. |
| 9 | ZONE D ADRESSAGE | Point placed in the dependent locality. |
| 10 | CENTRE VILLE | City center. |
| 00 | CENTRE DE LA VOIE | Point in the center of the street. |
| 90 | A CONTROLER | To check. |
| 99 | NON PRESENTE | Not available. |
Response example
{
"1": {
"Latitude":
"48.836069",
"Longitude":
"2.235501",
"CodeQualiteGeo":
"1",
"LibelleQualiteGeo":
"ENTREE"
}
}
Errors
| Error type | Response |
|---|---|
Missing, empty, or incorrect Licence
parameter
|
Returns latitude and longitude equal to 0.00.
|
Missing IDVoie parameter
|
500 Internal Server Error
|
Missing Num parameter
|
500 Internal Server Error
|
Missing Pays parameter
|
500 Internal Server Error
|
| Parameter typo |
500 Internal Server Error
|
Example of licence error:
{
"1": {
"Latitude": "0.00",
"Longitude": "0.00"
}
}
Test the API
Click the button below to test this endpoint live in your browser.
Open console
See also
Related to