Formato de Respuesta

Todos los endpoints de geocodificacion devuelven un envoltorio de respuesta normalizado independientemente del proveedor subyacente.

Envoltorio de Respuesta

{
  "results": [ ... ],
  "provider": "locationiq",
  "cached": false
}

Campo	Tipo	Descripcion
`results`	array	Lista de elementos de resultado
`provider`	string	Proveedor que atendio la solicitud (`here` o `locationiq`)
`cached`	boolean	Si la respuesta fue servida desde cache

Elemento de Resultado de Geocode / Reverse

{
  "label": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, United States",
  "position": { "lat": 37.42249, "lng": -122.08473 },
  "address": {
    "house_number": "1600",
    "street": "Amphitheatre Pkwy",
    "neighborhood": null,
    "city": "Mountain View",
    "county": null,
    "state": "California",
    "state_code": "CA",
    "postal_code": "94043",
    "country": "United States",
    "country_code": "USA"
  },
  "result_type": "house_number",
  "provider_id": "here:af:streetsection:abc123",
  "relevance": 1.0,
  "distance": null,
  "bounding_box": null
}

Referencia de Campos

Campo	Tipo	Descripcion
`label`	string	Cadena de texto completa formateada para visualizacion
`position.lat`	float	Latitud
`position.lng`	float	Longitud
`address`	object	Componentes estructurados de la direccion (ver abajo)
`result_type`	string	Tipo de resultado normalizado (ver abajo)
`provider_id`	string	Identificador especifico del proveedor
`relevance`	float \| null	Puntaje de relevancia 0-1
`distance`	float \| null	Distancia en metros (solo geocodificacion inversa)
`bounding_box`	array \| null	Flotantes `[south, north, west, east]`

Objeto Address

Campo	Tipo	Descripcion
`house_number`	string \| null	Numero de casa/edificio
`street`	string \| null	Nombre de la calle
`neighborhood`	string \| null	Barrio o distrito
`city`	string \| null	Ciudad, pueblo o aldea
`county`	string \| null	Condado o equivalente
`state`	string \| null	Nombre del estado o region
`state_code`	string \| null	Abreviatura del estado (ej., `CA`)
`postal_code`	string \| null	Codigo postal o ZIP
`country`	string \| null	Nombre del pais
`country_code`	string \| null	Codigo ISO 3166-1 alpha-3 (ej., `USA`)

Tipos de Resultado

Valor	Descripcion
`house_number`	Direccion especifica con numero de casa
`street`	Resultado a nivel de calle
`city`	Ciudad o pueblo
`locality`	Barrio, suburbio o aldea
`state`	Estado o area administrativa
`country`	Resultado a nivel de pais
`place`	Lugar general
`poi`	Punto de interes (negocio, punto de referencia)

Elemento de Resultado de Autocomplete

Los mismos campos que arriba, mas:

Campo	Tipo	Descripcion
`title`	string \| null	Nombre corto para visualizacion (ej., nombre del negocio)
`category`	string \| null	Categoria del lugar (ej., `Restaurant`)