📖 使用指南
🚀 快速开始
使用方法:只需两个步骤即可使用我们的代理服务
maps.googleapis.com 替换为 api.companysou.com步骤 2: 使用我们分配的 API Key(或使用调试 Key:
DEBUG_KEY_FOR_TESTING)
💡 发送邮件至
contact@aeio.dev 申请正式 API Key
https://maps.googleapis.com/maps/api/geocode/json?address=北京市&key=YOUR_API_KEY
# 通过我们的代理访问
https://api.companysou.com/maps/api/geocode/json?address=北京市&key=YOUR_ASSIGNED_KEY
# 或使用调试 Key 测试
https://api.companysou.com/maps/api/geocode/json?address=北京市&key=DEBUG_KEY_FOR_TESTING
💡 注意:直接使用当前访问的域名即可,无需修改端口号
🌐 Cloud Translation Basic v2
代理客户端 key 需要 translate 权限。翻译和语言检测消耗字符配额;语言列表使用独立请求配额。
将 translation.googleapis.com 替换为代理域名,保留 /language/translate/v2 路径。在 API 调试中选择 Translation 卡片,可翻译文本、检测语言或获取语言列表。
curl 'https://api.companysou.com/language/translate/v2?key=YOUR_ASSIGNED_KEY' \
-H 'Content-Type: application/json' \
--data '{"q":["The quick brown fox jumps over the lazy dog."],"target":"zh-CN","format":"text","model":"nmt"}'
🔑 API Key 使用
发送邮件至
contact@aeio.dev 申请正式 API Key
使用
DEBUG_KEY_FOR_TESTING 进行功能验证和测试。调试 Key 仅用于开发测试,有频率限制,生产环境请申请正式 Key
🔧 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 助手配置中:
✓ 已复制到剪贴板!
支持的 AI 客户端
Claude Code
在终端中运行以下命令:
去掉 --scope user 则仅安装到当前项目
任何 MCP 兼容客户端
这是一个标准的 HTTP MCP 端点(JSON-RPC 2.0),任何 MCP 兼容客户端都可以使用以下方式连接:
传输: HTTP(支持 SSE 流式)
协议: JSON-RPC 2.0
可用工具
地址 → 坐标
坐标 → 地址
搜索地点
地点详情
距离计算
海拔数据
路线规划
需要 placesaggregate 权限。一次请求可同时选择 INSIGHT_COUNT 和 INSIGHT_PLACES;仅匹配数量 ≤100 时返回地点 ID,详情需另外查询。支持 circle、region、customArea 过滤。
设备定位
使用示例
连接后,直接向 AI 助手提问:
💡 获取 API 密钥:发送邮件至 contact@aeio.dev 申请支持 MCP 的 API 密钥。
🔧 在线 MCP 调试器
直接在浏览器中测试 MCP 端点