Menu

Geocoding Apis

Geocoding Apis

🧭 What is the Geocoding API?

The Geocoding API allows you to convert addresses into geographic coordinates (latitude and longitude), and vice versa. It’s commonly used in mapping applications to place markers, calculate distances, or perform location-based searches.

With the GoMaps API, you get the same powerful functionality as Google’s Geocoding API, but on a custom domain: https://maps.gomaps.pro.


📚 GoMaps Geocoding API Documentation

🗺️ Endpoint for Forward Geocoding (Address → Coordinates)

URL:

arduino
https://maps.gomaps.pro/maps/api/geocode/json

Method: GET

Query Parameters:

Parameter Description Required
address The address to geocode. Yes
key Your GoMaps API key. Yes

Example Request:

http
GET https://maps.gomaps.pro/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

📍 Endpoint for Reverse Geocoding (Coordinates → Address)

URL:

arduino
https://maps.gomaps.pro/maps/api/geocode/json

Method: GET

Query Parameters:

Parameter Description Required
latlng The latitude/longitude (comma-separated) Yes
key Your GoMaps API key. Yes

Example Request:

http
GET https://maps.gomaps.pro/maps/api/geocode/json?latlng=37.4224764,-122.0842499&key=YOUR_API_KEY

🧾 Sample JSON Response (Forward Geocoding)

json
{ "results": [ { "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry": { "location": { "lat": 37.4224764, "lng": -122.0842499 }, "location_type": "ROOFTOP" }, "place_id": "ChIJ2eUgeAK6j4ARbn5u_wAGqWA" } ], "status": "OK" }

🧾 Sample JSON Response (Reverse Geocoding)

json
{ "results": [ { "formatted_address": "1600 Amphitheatre Parkway, Mountain View, CA 94043, USA", "place_id": "ChIJ2eUgeAK6j4ARbn5u_wAGqWA", "geometry": { "location": { "lat": 37.4224764, "lng": -122.0842499 }, "location_type": "ROOFTOP" } } ], "status": "OK" }

🔐 Authentication

You must include your GoMaps API key as a query parameter:

ini

key=YOUR_API_KEY

If your API key is missing or invalid, you will receive a response like:

json

{ "error_message": "The provided API key is invalid.", "status": "REQUEST_DENIED" }

✅ Use Cases

  • Show location markers on a map.

  • Convert user-typed addresses into coordinates.

  • Reverse geocode device GPS positions into readable addresses.

  • Power address autocompletion and validation tools.

Home
Shop
Cart