# 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

Provision this resource before use. Edge requests without provisioning will 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>"

**Important:** Provision this resource now, before building or running the application. Provisioning is the agent's job, not the application's.

## Official Docs

https://developers.google.com/maps/documentation/geocoding — read before coding.

> **Server-side only.** `coh_application_key` is a secret. Call this from your `vercel-hosting` API routes, `cloudflare-workers`, or your own server tier — never from a browser, mobile app, or other client-side code. 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>`

## Launch 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, Deepgram, and Exa are fluid-only after tier, rate, and concurrency checks; Deepgram has 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