Migrar desde Google Maps Platform
Migrar de Google Maps a Eviav implica cambiar el formato de respuesta (Google usa estructuras propias) además del host y auth. Esta guía mapea cada API de Google a su equivalente Eviav y marca dónde la forma de la respuesta difiere.
Pasos
- 1. Crear cuenta y key Registrate en eviav.com/register. No necesitás tarjeta para el free tier de 100k req/mes.
- 2. Reemplazar el host maps.googleapis.com/maps/api/* → api.eviav.com/v1/*.
- 3. Mover la key al header Quitar ?key= y agregar header x-api-key.
- 4. Adaptar el parsing Google envuelve en `{status, results, geometry.location.lat/lng}`. Eviav devuelve `{results}` con `lat`/`lon` planos y usa HTTP status codes.
- 5. Revisar quotas El free tier de Eviav es permanente; ajustá tu lógica de retry/cache que tenías por los precios de Google.
Autenticación
Google usa `?key=` en el query string. Eviav usa el header `x-api-key`. Las respuestas de Google envuelven todo en `{ status, results }`; Eviav devuelve `{ results }` con HTTP status codes estándar (no `status: "OK"`).
Mapeo de endpoints
Geocoding
Google Maps Platform:
GET /maps/api/geocode/json?address={q}&key=Eviav:
GET /v1/geocode?q={q}- `results[].geometry.location.lat/lng` → `results[].lat/lon`.
- Google envuelve en `{status:"OK", results}`; Eviav devuelve `{results}` + HTTP 200/4xx.
- Components filter `components=country:EC` → sesgo via `lat`/`lon`.
Reverse geocoding
Google Maps Platform:
GET /maps/api/geocode/json?latlng={lat},{lng}Eviav:
GET /v1/reverse?lat={lat}&lon={lon}- `latlng=lat,lng` (junto) → `lat=&lon=` (separados).
Directions
Google Maps Platform:
GET /maps/api/directions/json?origin=&destination=Eviav:
GET /v1/directions?coordinates={lon,lat;lon,lat}- Google: `origin`/`destination` como strings o lat,lng. Eviav: lista `coordinates` lon,lat.
- Respuesta: Google `routes[].legs[].steps[]` propio → Eviav OSRM-style `routes[].legs[].steps[]`.
- Polyline: Google encoded polyline → Eviav GeoJSON `geometry` (geometries=geojson).
Distance Matrix
Google Maps Platform:
GET /maps/api/distancematrix/json?origins=&destinations=Eviav:
GET /v1/matrix?coordinates={coords}- Google separa origins/destinations; Eviav toma una lista única `coordinates` y devuelve matriz NxN. Para NxM, recortás la submatriz.
Places Nearby
Google Maps Platform:
GET /maps/api/place/nearbysearch/json?location=&radius=&type=Eviav:
GET /v1/places?lat=&lon=&category=&radius=- `location=lat,lng` → `lat=&lon=`. `type=restaurant` → `category=restaurant`.
- Datos de POIs vienen de OpenStreetMap (no Google Places); la cobertura/atributos difieren.
Static Maps
Google Maps Platform:
GET /maps/api/staticmap?center=&zoom=&size=Eviav:
GET /v1/static?center=&zoom=&width=&height=- `size=600x400` → `width=600&height=400`. Markers con sintaxis propia de Eviav.
Time Zone
Google Maps Platform:
GET /maps/api/timezone/json?location=×tamp=Eviav:
GET /v1/timezone?lat=&lon=- Eviav devuelve la zona IANA y offset UTC sin requerir timestamp.
¿Necesitás ayuda con la migración?
Para volúmenes enterprise ofrecemos asistencia de migración con un Solutions Engineer. Hablá con ventas o escribinos a [email protected].