Geocoding API — Obtener coordenadas GPS

API de Geocodificación

El endpoint LATLG convierte un identificador de calle y un número de calle en coordenadas geográficas (latitud y longitud).

Documentación relacionada de Geocoding:

/LATLG/

Ir a Respuesta Ejemplo Errores ▶ Probar la API

Solicitud

Se admiten tanto GET como POST.

{SERVER_ADDRESS} y {LICENCE_CODE} son proporcionados por DQE al crear la cuenta. Póngase en contacto con su gestor de cuenta DQE para obtener estas credenciales.

GET POST

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

Ejemplos de código

Dirección válida

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

Sustituya los valores entre llaves por su propia información:

Parámetro	Descripción	Obl / Opc
SERVER_ADDRESS	Dirección del servidor DQE que procesará los datos.	Obligatorio
Licence	Su código de licencia DQE.	Obligatorio
IDVoie	Identificador único de la calle devuelto por el comando ADR.	Obligatorio
Num	Número de calle.	Obligatorio
Pays	Código de país ISO de 3 letras.	Obligatorio
Taille	Longitud máxima de la dirección. Valor por defecto: `38`.	Opcional
Instance	Valor personalizado devuelto tal cual en la respuesta.	Opcional

POSThttps://{SERVER_ADDRESS}/LATLG/

Envíe todos los parámetros en el cuerpo de la solicitud usando Content-Type: application/x-www-form-urlencoded. La dirección del servidor permanece en la URL.

Ejemplos de código

Dirección válida

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

Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.

Parámetro	Descripción	Obl / Opc
Licence	Su código de licencia DQE.	Obligatorio
IDVoie	Identificador único de la calle devuelto por el comando ADR.	Obligatorio
Num	Número de calle.	Obligatorio
Pays	Código de país ISO de 3 letras.	Obligatorio
Taille	Longitud máxima de la dirección. Valor por defecto: `38`.	Opcional
Instance	Valor personalizado devuelto tal cual en la respuesta.	Opcional

Respuesta

La respuesta JSON es un diccionario cuyas claves están numeradas de 1 a n. Cada elemento contiene las siguientes claves:

Clave	Descripción	Todos los países	Formato
Latitude	Latitud de la dirección.	Sí	Decimal
Longitude	Longitud de la dirección.	Sí	Decimal
CodeQualiteGeo	Código del tipo de calidad de geocodificación.	No	String
LibelleQualiteGeo	Etiqueta del tipo de calidad de geocodificación.	No	String

Códigos de calidad de geocodificación

CodeQualiteGeo	LibelleQualiteGeo	Descripción
1	ENTREE	Punto de acceso principal a un recinto abierto o cerrado, un grupo de edificios, o una parcela de terreno.
2	BATIMENT	Edificio o parte de un edificio.
3	ESCALIERS	Hueco de escalera, normalmente dentro de un edificio.
4	LOGEMENT	Vivienda o habitación dentro de un edificio.
5	PARCELLE CADASTRALE	Parcela catastral.
6	SEGMENT DE VOIE	Posición derivada del segmento de calle de conexión.
7	POINT D ACCESS TECHNIQUE	Punto de acceso técnico.
8	POINT DELIVRANCE POSTALE	Punto de entrega postal, como un buzón.
9	ZONE D ADRESSAGE	Punto situado en la localidad dependiente.
10	CENTRE VILLE	Centro de la ciudad.
00	CENTRE DE LA VOIE	Punto en el centro de la calle.
90	A CONTROLER	Por verificar.
99	NON PRESENTE	No disponible.

Ejemplo de respuesta

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

Errores

Tipo de error	Respuesta
Parámetro `Licence` ausente, vacío o incorrecto	Devuelve latitud y longitud iguales a `0.00`.
Falta el parámetro `IDVoie`	`500 Internal Server Error`
Falta el parámetro `Num`	`500 Internal Server Error`
Falta el parámetro `Pays`	`500 Internal Server Error`
Error tipográfico en un parámetro	`500 Internal Server Error`

Ejemplo de error de licencia:

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

Probar la API

Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.

Abrir consola

Ver también

Códigos de respuesta de la API — Referencia completa

Geocoding API — Obtener coordenadas GPS

/LATLG/

Solicitud

Ejemplos de código

Ejemplos de código

Respuesta

Códigos de calidad de geocodificación

Ejemplo de respuesta

Errores

Probar la API

Ver también

¿Fue útil este artículo?

Artículo anterior

Artículo siguiente