# Google Geocoding API

Proxies Google Maps Geocoding API. Convert addresses to coordinates and reverse. Pairs with Weather API (which needs lat/lng).

## 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.

## 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>`