Geocoding API
Der LATLG-Endpunkt wandelt eine Straßenkennung und eine Hausnummer in geografische Koordinaten (Breiten- und Längengrad) um.
Verwandte Geocoding-Dokumentation:
/LATLG/
Anfrage
Sowohl GET als auch POST werden unterstützt.
{SERVER_ADDRESS} und
{LICENCE_CODE} werden von DQE bei der Kontoerstellung
bereitgestellt. Wenden Sie sich an Ihren DQE-Kundenbetreuer,
um diese Zugangsdaten zu erhalten.
GEThttps://{SERVER_ADDRESS}/LATLG/?IDVoie={STREET_ID}&Num={NUM}&Pays={COUNTRY_CODE}&Taille={LENGTH}&Instance={VALUE}&Licence={LICENCE_CODE}
Codebeispiele
Gültige Adresse
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))
}
Ersetzen Sie die Werte in geschweiften Klammern durch Ihre eigenen Angaben:
| Parameter | Beschreibung | Pflicht/Opt |
|---|---|---|
| SERVER_ADDRESS | Adresse des DQE-Servers, der die Daten verarbeitet. | Pflicht |
| Licence | Ihr DQE-Lizenzcode. | Pflicht |
| IDVoie | Eindeutige Straßenkennung, die vom ADR-Befehl zurückgegeben wird. | Pflicht |
| Num | Hausnummer. | Pflicht |
| Pays | ISO-3-Buchstaben-Ländercode. | Pflicht |
| Taille |
Maximale Länge der Adresse. Standardwert:
38.
|
Optional |
| Instance | Benutzerdefinierter Wert, der unverändert in der Antwort zurückgegeben wird. | Optional |
POSThttps://{SERVER_ADDRESS}/LATLG/
Senden Sie alle Parameter im Request-Body im Format
Content-Type: application/x-www-form-urlencoded.
Die Serveradresse bleibt in der URL.
Codebeispiele
Gültige Adresse
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))
}
Fügen Sie die folgenden Parameter im Anfragetext
im Format
x-www-form-urlencoded hinzu.
| Parameter | Beschreibung | Pflicht/Opt |
|---|---|---|
| Licence | Ihr DQE-Lizenzcode. | Pflicht |
| IDVoie | Eindeutige Straßenkennung, die vom ADR-Befehl zurückgegeben wird. | Pflicht |
| Num | Hausnummer. | Pflicht |
| Pays | ISO-3-Buchstaben-Ländercode. | Pflicht |
| Taille |
Maximale Länge der Adresse. Standardwert:
38.
|
Optional |
| Instance | Benutzerdefinierter Wert, der unverändert in der Antwort zurückgegeben wird. | Optional |
Antwort
Die JSON-Antwort ist ein Dictionary, dessen Schlüssel von
1
bis n durchnummeriert sind. Jedes Element enthält
die folgenden Schlüssel:
| Schlüssel | Beschreibung | Alle Länder | Format |
|---|---|---|---|
| Latitude | Breitengrad der Adresse. | Ja | Dezimal |
| Longitude | Längengrad der Adresse. | Ja | Dezimal |
| CodeQualiteGeo | Code des Geocoding-Qualitätstyps. | Nein | String |
| LibelleQualiteGeo | Bezeichnung des Geocoding-Qualitätstyps. | Nein | String |
Geocoding-Qualitätscodes
| CodeQualiteGeo | LibelleQualiteGeo | Beschreibung |
|---|---|---|
| 1 | ENTREE | Hauptzugang zu einem offenen oder geschlossenen Gelände, einer Gebäudegruppe oder einem Grundstück. |
| 2 | BATIMENT | Gebäude oder Gebäudeteil. |
| 3 | ESCALIERS | Treppenhaus, normalerweise innerhalb eines Gebäudes. |
| 4 | LOGEMENT | Wohnung oder Raum innerhalb eines Gebäudes. |
| 5 | PARCELLE CADASTRALE | Katasterparzelle. |
| 6 | SEGMENT DE VOIE | Position, abgeleitet vom angrenzenden Straßensegment. |
| 7 | POINT D ACCESS TECHNIQUE | Technischer Zugangspunkt. |
| 8 | POINT DELIVRANCE POSTALE | Postzustellpunkt, z. B. ein Briefkasten. |
| 9 | ZONE D ADRESSAGE | Punkt innerhalb der zugeordneten Ortschaft. |
| 10 | CENTRE VILLE | Stadtzentrum. |
| 00 | CENTRE DE LA VOIE | Punkt in der Mitte der Straße. |
| 90 | A CONTROLER | Zu überprüfen. |
| 99 | NON PRESENTE | Nicht verfügbar. |
Antwortbeispiel
{
"1": {
"Latitude":
"48.836069",
"Longitude":
"2.235501",
"CodeQualiteGeo":
"1",
"LibelleQualiteGeo":
"ENTREE"
}
}
Fehler
| Fehlertyp | Antwort |
|---|---|
Fehlender, leerer oder falscher Parameter Licence
|
Gibt Breiten- und Längengrad mit dem Wert 0.00
zurück.
|
Fehlender Parameter IDVoie
|
500 Internal Server Error
|
Fehlender Parameter Num
|
500 Internal Server Error
|
Fehlender Parameter Pays
|
500 Internal Server Error
|
| Tippfehler im Parameter |
500 Internal Server Error
|
Beispiel für einen Lizenzfehler:
{
"1": {
"Latitude":
"0.00",
"Longitude":
"0.00"
}
}
API testen
Klicken Sie auf die Schaltfläche unten, um diesen Endpunkt live in Ihrem Browser zu testen.
Konsole öffnen
Siehe auch
Verknüpfung mit