eviav 0.1.0

Cliente oficial de Eviav — APIs geoespaciales (geocoding, ruteo, mapas, isócronas, IA) para LATAM. Sync + async sobre httpx.

eviav — Python client

Cliente oficial de Eviav para Python. APIs geoespaciales (geocoding, ruteo, mapas, isócronas, optimización de flota, IA) para LATAM. Sync + async sobre httpx.

pip install eviav

Quickstart (sync)

from eviav import Client

client = Client(api_key="eviav_live_…")

res = client.geocode("Av. Amazonas, Quito")
print(res["results"][0]["lat"], res["results"][0]["lon"])

# Ruteo
route = client.directions([(-78.51, -0.22), (-78.48, -0.12)], steps=True)
print(route["routes"][0]["distance"], "metros")

client.close()

O como context manager:

with Client(api_key="…") as client:
    res = client.geocode("Quito")

Quickstart (async)

import asyncio
from eviav import AsyncClient

async def main():
    async with AsyncClient(api_key="eviav_live_…") as client:
        res = await client.geocode("Quito")
        print(res["results"][0]["label"])

asyncio.run(main())

Métodos

Todos disponibles en Client (sync) y AsyncClient (async, awaitables):

Método	Endpoint
geocode(q, lat=, lon=, limit=)	GET /v1/geocode
reverse(lat, lon)	GET /v1/reverse
search(text, lat=, lon=, limit=)	GET /v1/search
places(lat, lon, category, radius=)	GET /v1/places
directions(coordinates, steps=, profile=)	GET /v1/directions
matrix(coordinates)	GET /v1/matrix
optimize(coordinates, roundtrip=)	POST /v1/optimization
fleet(body)	POST /v1/fleet
match(coordinates)	GET /v1/match
nearest(point, number=)	GET /v1/nearest
isochrone(lat, lon, contours=, costing=)	GET /v1/isochrone
elevation(lat, lon)	GET /v1/elevation
timezone(lat, lon)	GET /v1/timezone
tilequery(lat, lon, radius=)	GET /v1/tilequery
list_datasets(layer=)	GET /v1/datasets
grounding(query, lat=, lon=)	POST /v1/grounding

Las coordenadas son tuplas (lon, lat) (formato GeoJSON).

Manejo de errores

from eviav import Client, EviavError

try:
    client.geocode("")
except EviavError as e:
    print(e.status, e.code, e.request_id)

Reintentos

Reintenta automáticamente en 429 y 5xx con backoff exponencial, honrando el header Retry-After. Configurable con max_retries=.

Licencia

MIT © Eviav