π Usage Guide
π Quick Start
How to Use: Just two steps to use our proxy service
maps.googleapis.com with gmapapi.jsonutil.onlineStep 2: Use our assigned API Key (or use debug Key:
DEBUG_KEY_FOR_TESTING)
π‘ Email
contact@aeio.dev to apply for an official API Key
https://maps.googleapis.com/maps/api/geocode/json?address=Beijing&key=YOUR_API_KEY
# Access through our proxy
https://gmapapi.jsonutil.online/maps/api/geocode/json?address=Beijing&key=YOUR_ASSIGNED_KEY
# Or use debug Key for testing
https://gmapapi.jsonutil.online/maps/api/geocode/json?address=Beijing&key=DEBUG_KEY_FOR_TESTING
π‘ Note: Simply use the domain you are currently visiting, no need to change the port
π API Key Usage
Send email to
contact@aeio.dev to apply for an official API Key
Use
DEBUG_KEY_FOR_TESTING for feature verification and testing. Debug key is only for development and testing with rate limits. Please apply for an official key for production use
π API Documentation
View Google official documentation, fully compatible
π§ API Debug Tool
Select an API type, then enter parameters to test:
π Quick Examples
Click the buttons below to quickly test common APIs:
π Code Examples
Python Example
import requests
# Address to coordinates
response = requests.get(
"https://YOUR_DOMAIN/maps/api/geocode/json",
params={"address": "Tiananmen Square, Beijing", "key": "DEBUG_KEY_FOR_TESTING"}
)
print(response.json())
# Route planning
response = requests.get(
"https://YOUR_DOMAIN/maps/api/directions/json",
params={"origin": "Beijing", "destination": "Shanghai", "key": "DEBUG_KEY_FOR_TESTING"}
)
print(response.json())
JavaScript (Node.js) Example
// Address to coordinates
const response = await fetch(
'https://YOUR_DOMAIN/maps/api/geocode/json?address=Tiananmen Square, Beijing&key=DEBUG_KEY_FOR_TESTING'
);
const data = await response.json();
console.log(data);
// Place search
const placesResponse = await fetch(
'https://YOUR_DOMAIN/maps/api/place/nearbysearch/json?location=39.908722,116.397498&radius=1000&type=restaurant&key=DEBUG_KEY_FOR_TESTING'
);
const placesData = await placesResponse.json();
console.log(placesData);
Java Example
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
// Address to coordinates
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://YOUR_DOMAIN/maps/api/geocode/json?address=Tiananmen Square, Beijing&key=DEBUG_KEY_FOR_TESTING"))
.build();
HttpResponse response = client.send(request,
HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
Go Example
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
// Address to coordinates
resp, err := http.Get("https://YOUR_DOMAIN/maps/api/geocode/json?address=Tiananmen Square, Beijing&key=DEBUG_KEY_FOR_TESTING")
if err != nil {
fmt.Println(err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
curl Example
# Address to coordinates
curl "https://YOUR_DOMAIN/maps/api/geocode/json?address=Tiananmen Square, Beijing&key=DEBUG_KEY_FOR_TESTING"
# Route planning
curl "https://YOUR_DOMAIN/maps/api/directions/json?origin=Beijing&destination=Shanghai&key=DEBUG_KEY_FOR_TESTING"
# Place search
curl "https://YOUR_DOMAIN/maps/api/place/nearbysearch/json?location=39.908722,116.397498&radius=1000&type=restaurant&key=DEBUG_KEY_FOR_TESTING"
# Static map
curl "https://YOUR_DOMAIN/maps/api/staticmap?center=Beijing&zoom=12&size=600x400&key=DEBUG_KEY_FOR_TESTING"
PHP Example
<?php
// Address to coordinates
$url = "https://YOUR_DOMAIN/maps/api/geocode/json";
$params = [
'address' => 'Tiananmen Square, Beijing',
'key' => 'DEBUG_KEY_FOR_TESTING'
];
$response = file_get_contents($url . '?' . http_build_query($params));
$data = json_decode($response, true);
print_r($data);
?>
π‘ Tip: Please replace YOUR_DOMAIN with the actual access domain
π€ MCP Protocol Support
This service supports Model Context Protocol (MCP), enabling seamless integration with AI assistants like Claude Code and Gemini for Google Maps functionality.
π Quick Integration
Simply add this MCP server URL to your AI assistant configuration:
β Copied to clipboard!
Supported AI Clients
Claude Code
Run this command in your terminal:
Remove --scope user to install for current project only
Any MCP-Compatible Client
This is a standard HTTP MCP endpoint (JSON-RPC 2.0). Any MCP-compatible client can connect using:
Transport: HTTP (supports SSE streaming)
Protocol: JSON-RPC 2.0
Available Tools
Address β Coordinates
Coordinates β Address
Search places
Place information
Distance calculation
Elevation data
Route planning
Usage Example
Once connected, simply ask your AI assistant:
π‘ Get an API Key: Contact contact@aeio.dev to obtain your API key with MCP access enabled.
π§ Online MCP Debugger
Test the MCP endpoint directly in your browser