Geocoding API — GPS-Koordinaten abrufen

Geocoding API

Der LATLG-Endpunkt wandelt eine Straßenkennung und eine Hausnummer in geografische Koordinaten (Breiten- und Längengrad) um.

Verwandte Geocoding-Dokumentation:

/LATLG/

Direkt zu Antwort Beispiel Fehler ▶ API testen

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.

GET POST

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

Codebeispiele

Gültige Adresse

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))
}

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 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))
}

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

API-Antwortcodes — Vollständige Referenz

Geocoding API — GPS-Koordinaten abrufen

/LATLG/

Anfrage

Codebeispiele

Codebeispiele

Antwort

Geocoding-Qualitätscodes

Antwortbeispiel

Fehler

API testen

Siehe auch

War dieser Beitrag hilfreich?

Vorheriger Artikel

Nächster Artikel