🏠 Home

Google Maps API Proxy

Complete Google Maps API Proxy Service + Interactive Debug Tool

πŸ“– Usage Guide

πŸš€ Quick Start

How to Use: Just two steps to use our proxy service

Step 1: Replace domain maps.googleapis.com with gmapapi.jsonutil.online
Step 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
# Example from Google official documentation
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

πŸ”§ Apply for Official Key
Send email to contact@aeio.dev to apply for an official API Key
πŸ§ͺ Use Debug 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
πŸ’‘ Recommended: For stable service experience and higher request limits, we recommend applying for an official API Key.

πŸ“š API Documentation

View Google official documentation, fully compatible

πŸ’‘ All parameters and usage methods are fully compatible with Google official API

πŸ”§ 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:

https://gmapapi.jsonutil.online/mcp?key=YOUR_API_KEY

βœ“ Copied to clipboard!

Supported AI Clients

πŸ€–

Claude Code

Run this command in your terminal:

claude mcp add --scope user --transport http google-maps https://gmapapi.jsonutil.online/mcp?key=YOUR_API_KEY

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:

URL: https://gmapapi.jsonutil.online/mcp?key=YOUR_API_KEY
Transport: HTTP (supports SSE streaming)
Protocol: JSON-RPC 2.0

Available Tools

πŸ“
maps_geocode
Address β†’ Coordinates
🎯
maps_reverse_geocode
Coordinates β†’ Address
πŸ”
maps_search_places
Search places
πŸ“‹
maps_place_details
Place information
πŸ“
maps_distance_matrix
Distance calculation
⛰️
maps_elevation
Elevation data
🧭
maps_directions
Route planning

Usage Example

Once connected, simply ask your AI assistant:

"Find the coordinates of Beijing Tiananmen Square"
"What restaurants are near these coordinates?"
"Calculate the distance from Beijing to Shanghai"

πŸ’‘ 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

Modify the JSON parameters based on the selected tool
Click "Test MCP Request" to see the response here...
βœ“ Status: Ready
⏱ Time: -