🏠 返回首页

Google Maps API 代理

完整的 Google Maps API 代理服务 + 交互式调试工具

📖 使用指南

🚀 快速开始

使用方法:只需两个步骤即可使用我们的代理服务

步骤 1: 将域名 maps.googleapis.com 替换为 gmapapi.jsonutil.online
步骤 2: 使用我们分配的 API Key(或使用调试 Key:DEBUG_KEY_FOR_TESTING
💡 发送邮件至 contact@aeio.dev 申请正式 API Key
# Google 官方文档中的示例
https://maps.googleapis.com/maps/api/geocode/json?address=北京市&key=YOUR_API_KEY

# 通过我们的代理访问
https://gmapapi.jsonutil.online/maps/api/geocode/json?address=北京市&key=YOUR_ASSIGNED_KEY


# 或使用调试 Key 测试
https://gmapapi.jsonutil.online/maps/api/geocode/json?address=北京市&key=DEBUG_KEY_FOR_TESTING

💡 注意:直接使用当前访问的域名即可,无需修改端口号

🔑 API Key 使用

🔧 申请正式 Key
发送邮件至 contact@aeio.dev 申请正式 API Key
🧪 使用调试 Key
使用 DEBUG_KEY_FOR_TESTING 进行功能验证和测试。调试 Key 仅用于开发测试,有频率限制,生产环境请申请正式 Key
💡 推荐:为了获得稳定的服务体验和更高的请求限额,建议申请正式 API Key。

📚 API 文档

查看 Google 官方文档,完全兼容

💡 所有参数和使用方法与 Google 官方 API 完全兼容

🔧 API 调试工具

选择一个 API 类型,然后输入参数进行测试:

🚀 快速示例

点击下方按钮快速测试常用 API:

📝 代码示例

Python 示例

import requests

# 地址转坐标
response = requests.get(
    "https://YOUR_DOMAIN/maps/api/geocode/json",
    params={"address": "北京市天安门广场", "key": "DEBUG_KEY_FOR_TESTING"}
)
print(response.json())

# 路线规划
response = requests.get(
    "https://YOUR_DOMAIN/maps/api/directions/json",
    params={"origin": "北京市", "destination": "上海市", "key": "DEBUG_KEY_FOR_TESTING"}
)
print(response.json())

JavaScript (Node.js) 示例

// 地址转坐标
const response = await fetch(
    'https://YOUR_DOMAIN/maps/api/geocode/json?address=北京市天安门广场&key=DEBUG_KEY_FOR_TESTING'
);
const data = await response.json();
console.log(data);

// 地点搜索
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 示例

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

// 地址转坐标
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://YOUR_DOMAIN/maps/api/geocode/json?address=北京市天安门广场&key=DEBUG_KEY_FOR_TESTING"))
    .build();

HttpResponse response = client.send(request,
    HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Go 示例

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    // 地址转坐标
    resp, err := http.Get("https://YOUR_DOMAIN/maps/api/geocode/json?address=北京市天安门广场&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 示例

# 地址转坐标
curl "https://YOUR_DOMAIN/maps/api/geocode/json?address=北京市天安门广场&key=DEBUG_KEY_FOR_TESTING"

# 路线规划
curl "https://YOUR_DOMAIN/maps/api/directions/json?origin=北京市&destination=上海市&key=DEBUG_KEY_FOR_TESTING"

# 地点搜索
curl "https://YOUR_DOMAIN/maps/api/place/nearbysearch/json?location=39.908722,116.397498&radius=1000&type=restaurant&key=DEBUG_KEY_FOR_TESTING"

# 静态地图
curl "https://YOUR_DOMAIN/maps/api/staticmap?center=Beijing&zoom=12&size=600x400&key=DEBUG_KEY_FOR_TESTING"

PHP 示例

 '北京市天安门广场',
    'key' => 'DEBUG_KEY_FOR_TESTING'
];

$response = file_get_contents($url . '?' . http_build_query($params));
$data = json_decode($response, true);

print_r($data);
?>

💡 提示:请将 YOUR_DOMAIN 替换为实际的访问域名

🤖 MCP 协议支持

本服务支持 Model Context Protocol (MCP) 协议,可让 Claude Code、Gemini 等 AI 助手无缝使用 Google Maps 功能。

🚀 快速接入

只需将此 MCP 服务器 URL 添加到您的 AI 助手配置中:

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

✓ 已复制到剪贴板!

支持的 AI 客户端

🤖

Claude Code

在终端中运行以下命令:

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

去掉 --scope user 则仅安装到当前项目

🔌

任何 MCP 兼容客户端

这是一个标准的 HTTP MCP 端点(JSON-RPC 2.0),任何 MCP 兼容客户端都可以使用以下方式连接:

URL: https://gmapapi.jsonutil.online/mcp?key=YOUR_API_KEY
传输: HTTP(支持 SSE 流式)
协议: JSON-RPC 2.0

可用工具

📍
maps_geocode
地址 → 坐标
🎯
maps_reverse_geocode
坐标 → 地址
🔍
maps_search_places
搜索地点
📋
maps_place_details
地点详情
📏
maps_distance_matrix
距离计算
⛰️
maps_elevation
海拔数据
🧭
maps_directions
路线规划

使用示例

连接后,直接向 AI 助手提问:

"帮我查一下北京天安门广场的坐标"
"这个坐标附近有什么餐厅?"
"计算一下从北京到上海的距离"

💡 获取 API 密钥:发送邮件至 contact@aeio.dev 申请支持 MCP 的 API 密钥。

🔧 在线 MCP 调试器

直接在浏览器中测试 MCP 端点

根据所选工具修改 JSON 参数
点击"测试 MCP 请求"查看响应...
✓ 状态: 就绪
⏱ 耗时: -