📖 使用指南
🚀 快速开始
使用方法:只需两个步骤即可使用我们的代理服务
步骤 1: 将域名
步骤 2: 使用我们分配的 API Key(或使用调试 Key:
💡 发送邮件至
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
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。
💡 所有参数和使用方法与 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
传输: 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 请求"查看响应...
✓ 状态: 就绪
⏱ 耗时: -