Reverse Geocoding API
Der SINGLE-Endpunkt wandelt geografische Koordinaten (Breiten- und Längengrad) in eine Straßenadresse um.
Verwandte Geocoding-Dokumentation:
/SINGLE/
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}/SINGLE/?Pays={COUNTRY_CODE}&Licence={LICENCE_CODE}&Lat={LATITUDE}&Lon={LONGITUDE}&DistAdr={DISTANCE}
Codebeispiele
Gültige Koordinaten
curl "https://{SERVER_ADDRESS}/SINGLE/?Pays=FRA&Lat=48.836069&Lon=2.235501&DistAdr=1&Licence={LICENCE_CODE}"
fetch("https://{SERVER_ADDRESS}/SINGLE/?" + new URLSearchParams({
Pays: "FRA",
Lat: "48.836069",
Lon: "2.235501",
DistAdr: "1",
Licence: "{LICENCE_CODE}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/SINGLE/",
params={
"Pays": "FRA",
"Lat": "48.836069",
"Lon": "2.235501",
"DistAdr": "1",
"Licence": "{LICENCE_CODE}",
},
)
print(response.json())
<?php
$params = http_build_query([
'Pays' => 'FRA',
'Lat' => '48.836069',
'Lon' => '2.235501',
'DistAdr' => '1',
'Licence' => '{LICENCE_CODE}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/SINGLE/?{$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}/SINGLE/', {
params: {
Pays: 'FRA',
Lat: '48.836069',
Lon: '2.235501',
DistAdr: '1',
Licence: '{LICENCE_CODE}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/SINGLE/"
+ "?Pays=FRA&Lat=48.836069&Lon=2.235501&DistAdr=1&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}/SINGLE/" +
"?Pays=FRA&Lat=48.836069&Lon=2.235501&DistAdr=1&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}/SINGLE/" +
"?Pays=FRA&Lat=48.836069&Lon=2.235501&DistAdr=1&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 |
| Pays | ISO-3-Buchstaben-Ländercode. | Pflicht |
| Lat | Breitengrad im Dezimalformat. | Pflicht |
| Lon | Längengrad im Dezimalformat. | Pflicht |
| DistAdr | Suchradius in Kilometern. | Pflicht |
POSThttps://{SERVER_ADDRESS}/SINGLE/
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 Koordinaten
curl -X POST "https://{SERVER_ADDRESS}/SINGLE/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "Pays=FRA" \
-d "Lat=48.836069" \
-d "Lon=2.235501" \
-d "DistAdr=1"
fetch("https://{SERVER_ADDRESS}/SINGLE/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
Pays: "FRA",
Lat: "48.836069",
Lon: "2.235501",
DistAdr: "1"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/SINGLE/",
data={
"Licence": "{LICENCE_CODE}",
"Pays": "FRA",
"Lat": "48.836069",
"Lon": "2.235501",
"DistAdr": "1",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/SINGLE/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'Pays' => 'FRA',
'Lat' => '48.836069',
'Lon' => '2.235501',
'DistAdr' => '1',
]));
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}/SINGLE/', qs.stringify({
Licence: '{LICENCE_CODE}',
Pays: 'FRA',
Lat: '48.836069',
Lon: '2.235501',
DistAdr: '1'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&Pays=FRA&Lat=48.836069&Lon=2.235501&DistAdr=1";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/SINGLE/"))
.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}",
["Pays"] = "FRA",
["Lat"] = "48.836069",
["Lon"] = "2.235501",
["DistAdr"] = "1"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/SINGLE/",
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("Pays", "FRA")
form.Set("Lat", "48.836069")
form.Set("Lon", "2.235501")
form.Set("DistAdr", "1")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/SINGLE/", 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 |
| Pays | ISO-3-Buchstaben-Ländercode. | Pflicht |
| Lat | Breitengrad im Dezimalformat. | Pflicht |
| Lon | Längengrad im Dezimalformat. | Pflicht |
| DistAdr | Suchradius in Kilometern. | Pflicht |
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 | Frankreich | International |
|---|---|---|---|
| IDLocalite | Eindeutiger Code für jede Stadt. Für Frankreich ist dies der INSEE-Code. | STRING(10) | STRING(10) |
| Pays | ISO-Ländercode. | STRING(3) | STRING(3) |
| CodePostal | Postleitzahl der Stadt. | INTEGER(5) | STRING(10) |
| Localite | Stadtname. | STRING(38) | STRING(50) |
| Cedex | Gibt an, ob es sich um einen Cedex handelt. | STRING(1) | STRING(1) |
| IDVoie | Eindeutige Straßenkennung. | INTEGER(8) | STRING(10) |
| CodeVoie | Eindeutiger Code der Straße. | INTEGER(8) | STRING(10) |
| Voie | Straßenname. | STRING(38) | STRING(50) |
| Numero / Num | Hausnummer. | INTEGER(4) | INTEGER(4) |
| NbNumero | Anzahl der gefundenen Hausnummern. | INTEGER(4) | INTEGER(4) |
| Instance | In der Anfrage übergebener und in der Antwort zurückgegebener Wert. | INTEGER(1) | INTEGER(1) |
| Saisie | Leer. | - | - |
| ListeNumero | Leer. | - | - |
Beispiel:
{
"1": {
"IDLocalite": "92044",
"Saisie": "",
"Nbnumero": "1",
"Pays": "FRA",
"IDVoie": "1749869",
"Voie": "RUE VICTOR HUGO",
"Numero": "104",
"Instance": "",
"ListeNumero": "",
"Num": "104",
"CodePostal": "92300",
"NbNumero": "1",
"Localite": "LEVALLOIS PERRET",
"Cedex": "0",
"CodeVoie": "1749869"
}
}
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