SuperAPI AI 工具集

google-maps

数据与分析

查看项目

更新于 10-15 21:41

技能介绍

用途:作为 Google Maps API 与 Google Places API 的替代,提供地点搜索、地点详情和评论数据,返回干净的 JSON,每次调用为一次普通 HTTP GET,按次付费。无需 Google Cloud 项目、API 密钥限制规则或 Places API 按请求计费。

主要能力:共 4 个 GET 端点,均为 $0.005/次:/api/place/search(按文本查询匹配地点,可选坐标锚定)、/api/place/{fid}(按 feature ID 获取地点完整详情)、/api/place/{fid}/reviews(地点评论)、/api/review/{id}(按 ID 获取单条评论)。搜索必填 query,可选 languageCode、countryCode、latitude、longitude、offset、zoom;评论支持 sort(relevant、newest、highest、lowest)与 cursor。响应统一为 { "status": number, "message": string, "data": ... },HTTP 状态与 status 一致。

使用方式:基础 URL 为 https://google-maps.fetcher.sh。两种付费方式:预付费额度(推荐,在 https://fetcher.sh/topup 获取密钥),设置 export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx" 后以 Authorization: Bearer 头调用;或 x402 按次付费,省略该头,无支付的 GET 返回 402 及机器可读的支付要求(USDC on Base、Polygon、Arbitrum、Monad 或 Solana),@x402/fetch 可自动签名并重试。也支持 MCP,配置 url 为 https://google-maps.fetcher.sh/mcp 并带 Authorization 头;免费工具含 search_endpoints、describe_endpoint、check_balance,付费工具含 fetch_data、topup_credits 及快捷工具 google_maps_place_search。

适用场景:需要地点搜索、详情与评论数据,且希望避免 Google Cloud 配置与按请求计费的开发者或智能体。

限制:错误码 400(参数缺失/无效)、401(密钥未知或已轮换)、402(需支付或额度耗尽)、404(非计价路径);无速率限制;上游失败不退款(结算先于交付)。完整参考见 https://google-maps.fetcher.sh/skill.md、OpenAPI 3.1 契约 https://google-maps.fetcher.sh/openapi.json 与 https://google-maps.fetcher.sh/llms.txt。