Geocodificación

Buscar una dirección o saber qué hay en una coordenada, con datos de OpenStreetMap de Chile.

Buscar una dirección

POSThttps://api.drometra.com/v1/geocoding/searches

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

textobligatoriostring
limitinteger

Respuesta · 200

  • array de objectsiempre
  • objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X POST "https://api.drometra.com/v1/geocoding/searches" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "…"
  }'
respuesta · 200
{
  "results": [
    {
      "label": "…",
      "coordinate": {
        "latitude": 0,
        "longitude": 0
      },
      "precision": "address",
      "address": {
        "road": "…",
        "houseNumber": "…",
        "locality": "…",
        "region": "…",
        "postcode": "…"
      }
    }
  ],
  "provenance": {
    "kind": "nominatim",
    "engine": "…",
    "engineVersion": "…",
    "dataVersion": "…",
    "coverage": {
      "id": "…",
      "status": "covered"
    }
  }
}

Ver qué hay en una coordenada

POSThttps://api.drometra.com/v1/geocoding/reverse

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

coordinatesobligatorioarray de object

Respuesta · 200

  • array de objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X POST "https://api.drometra.com/v1/geocoding/reverse" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "coordinates": []
  }'
respuesta · 200
{
  "items": [
    {
      "address": {
        "label": "…",
        "locality": "…"
      }
    }
  ]
}