Convert an address, place name, street, or intersection into coordinates and structured location results. Use when input is text and you need coordinates before routing, weather, or search. Supports street-level resolution and proximity biasing.

Convert coordinates into the nearest address, street, or place. Use when starting from GPS coordinates or a map position.

Generate routes, ETAs, and turn-by-turn directions between locations. Prefer the preset arg (car_default, truck_53, truck_tanker, bike, walk, transit, etc.) — presets bake in freight baselines so trucks actually stay on freight corridors. Raw costing + truck_* knobs remain for advanced callers. ETAs are ISO-8601 in the destination's local timezone.

Retrieve live traffic conditions, congestion, and speed for a location. Coverage: live data for ~30 major US metros; returns degraded or empty values outside these areas. For rural coordinates, qualify the response.

Get current and forecast weather for a location, including severe weather alerts and minute-by-minute precipitation. Use for destination conditions, travel planning, or route risk assessment.

Generate travel-time or travel-distance reachability polygons from an origin. Pass MULTIPLE bands in one call — e.g. contours_minutes:[10,20,30] returns three nested polygons in a single response. Output is GeoJSON ready for Mapbox / Leaflet.

CATEGORY-specific POI search near a point — gas stations, truck stops, restaurants, charging stations, etc. Use this when the user has a specific TYPE of place in mind. For broader DISCOVERY (e.g. 'cities within 50 miles'), use explore instead.

Geocode multiple addresses, intersections, or place queries in one request with structured per-record results. Use for bulk operations instead of repeated single geocode calls. Max 50 per batch.

BROWSING / DISCOVERY search — cities, neighbourhoods, or mixed venues near a location. Supports population filtering ('cities > 100k'), distance/population sorting, and layer filtering. For specific POI categories, use search_places instead.

Check current usage, remaining limits, plan, and quota breakdown for the caller. FREE TO CALL — never counts against your quota, never blocked by it. Use this proactively when the user asks about usage or seems near limits.

Mint a fresh API key for your current authenticated user/tenant. Useful for CLI workflows, key rotation, or MCP clients that hide the configured Bearer. The new key is tied to your existing plan. Counts as 1 query against your daily quota.