# Google Geocoding API

Proxies Google Maps Geocoding API. Convert addresses to coordinates and reverse. Pairs with Weather API when you want canonical coordinates before calling weather by lat/lon.

## Prerequisites

Edge calls require this resource to be provisioned first; unprovisioned calls return an error.

### Provision

    curl -s -X POST https://cohesivity.ai/api/resources/google-geocoding-api \
      -H "Authorization: Bearer <coh_management_key>"

### Delete

    curl -s -X DELETE https://cohesivity.ai/api/resources/google-geocoding-api \
      -H "Authorization: Bearer <coh_management_key>"

Provisioning happens once, before the application runs; the running application does not provision its own resources.

## Official Docs

https://developers.google.com/maps/documentation/geocoding covers the full parameter and response reference.

> **Server-side only.** `coh_application_key` is a secret; browser JS, mobile bundles, and other client-side code cannot hold it safely. This call belongs in a Railway-hosted server, `cloudflare-workers`, or your own server tier. See the canonical key-secrecy directive in `.cohesivity` for details.

## Edge Usage

- **Base URL:** https://cohesivity.ai/edge/google-geocoding-api
- **Auth:** `coh_application_key` as the **key** query parameter
- **Format:** same as Google's Geocoding API

## Examples

- Geocode: `GET https://cohesivity.ai/edge/google-geocoding-api/maps/api/geocode/json?address=San+Francisco,CA&key=<coh_application_key>`
- Reverse: `GET https://cohesivity.ai/edge/google-geocoding-api/maps/api/geocode/json?latlng=37.7749,-122.4194&key=<coh_application_key>`

## Rate Limits

Ephemeral tenants pause as a whole if any authoritative hard cap below is exceeded. Claimed tiers use account-scoped buckets shared across every project owned by the Cohesivity user; OpenAI, AI Gateway, Deepgram, and Exa are fluid-only after tier, rate, and concurrency checks; AI Gateway and Deepgram have no fixed monthly usage bucket for claimed tiers.

**Ephemeral**

- requests: 100 per ephemeral tenant lifetime before claim or expiry
- requests: 5 per minute

**Claimed Free**

- requests: 15 per minute
- requests: 500 per month

**Claimed Plus**

- requests: 60 per minute
- requests: 5000 per month

**Claimed Pro**

- requests: 300 per minute
- requests: 25000 per month