Compatibilidad: Google y Nominatim
Cambie la URL base y conserve su código cliente. Esta página enumera lo que se admite, según la especificación de la API (OpenAPI 1.0.0).
Modo Google Geocoding
| Elemento | Compatibilidad |
|---|---|
| Ruta | /compat/google/maps/api/geocode/json |
| Geocodificación directa | `address` (hasta 512 caracteres) |
| Geocodificación inversa | `latlng`, con la forma `lat,lng` |
| Filtros | `components`: solo se tiene en cuenta `country:XX`; `language` y `region` aceptados |
| Campos de respuesta | status, error_message, results[].formatted_address, place_id, types, partial_match, address_components, geometry.location, geometry.location_type, geometry.viewport |
| Errores | `status` en formato Google (OK, ZERO_RESULTS, OVER_QUERY_LIMIT, REQUEST_DENIED, INVALID_REQUEST, UNKNOWN_ERROR), HTTP 200 |
| Place IDs | Presentes en el formato; los valores son identificadores de Addrova |
| Extensión de Addrova | Lista `attribution` de fuentes y licencias |
Modo Nominatim
| Elemento | Compatibilidad |
|---|---|
| Búsqueda | /compat/nominatim/search con `q`, `format` (json o jsonv2, jsonv2 por defecto), `limit` (de 1 a 40, 10 por defecto), `countrycodes` (códigos ISO separados por comas), `addressdetails` (0 o 1, 0 por defecto) |
| Inversa | /compat/nominatim/reverse con `lat`, `lon`, `format`, `addressdetails` (1 por defecto) |
| Campos de respuesta | place_id, licence, lat, lon, display_name, category (jsonv2) o class (json), type, importance, address, boundingbox |
| Inversa sin resultado | {"error": "Unable to geocode"} |
| Fuera del alcance | Teselas de mapa, búsqueda de objetos de OSM |
Autenticación en las rutas de compatibilidad
| Método | Cómo |
|---|---|
| Parámetro de consulta | `key=ADDROVA_KEY`, aceptado solo en las rutas /compat, por compatibilidad. Nunca se registra. |
| Cabecera | `X-API-Key`, o la clave como token bearer |