Google Maps API

Google Maps 搜索 API

在 Google Maps 上搜索与查询词和地点匹配的地点：每次请求最多返回 20 条标准化地点记录，包含评分、地址和基本联系方式。

免费开始下载示例或 JSON

US$1.50/千次请求，按请求付费，无需订阅。

coffee shop - Google Maps
google.com/maps/search/coffee%20shop
coffee shop in Austin, TX
ResultsShare

Mañana Coffee House

4.6(1,284)

Coffee shop · 612 W 6th St, Austin, TX 78701, USA

Mañana Coffee House
Google Maps
API 返回的内容items[0]
{
"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"cid": "8234917364550128200",
"name": "Mañana Coffee House",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"category": "Coffee shop",
"categories": [...],
"address": "612 W 6th St, Austin, TX 78701, USA",
"street": "612 W 6th St",
... 还有 14 个字段
}
可用率
100.00%
30d · 63,111 次调用
请求数
63,473
30d · 按周，近 12 周
响应时间
2.7s
中位数 · 30d

价格与服务商

Google Maps 搜索 API 价格：一个 API，6 个可互换的服务商

最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。

服务商
1Heron优先响应可用率 94.42%p50 2610ms占调用的 12.2%US$1.50/千次请求flat2Lynx备用 1可用率 99.01%p50 2604ms占调用的 83.1%US$1.75/千次请求flat3Badger备用 2可用率 100.00%p50 2446ms占调用的 0.0%US$2.00/千次请求flat4Chameleon备用 3可用率 99.19%p50 2118ms占调用的 4.4%US$2.97/千次请求flat5Meerkat备用 4可用率 100.00%p50 1607ms占调用的 0.0%US$3.25/千次请求flat6Octopus备用 5可用率 100.00%p50 28816ms占调用的 0.2%US$3.36/千条结果每次请求最多 US$0.0705
你需支付
US$15.00
US$1.50/千次请求，只为实际用量付费。没有月度套餐。
有了 US$0.10 的初始余额，你的前 66 次请求免费。

试一试

一个请求获取 Google Maps 搜索

requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `cid` 或 `street`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个地点确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

这个示例展示了 26 个字段中的 24 个。查看全部字段

{
  "found": true,
  "data": {
    "items": [
      {
        "placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
        "cid": "8234917364550128200",
        "name": "Mañana Coffee House",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Breakfast restaurant",
          "Bakery"
        ],
        "address": "612 W 6th St, Austin, TX 78701, USA",
        "street": "612 W 6th St",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78701",
        "countryCode": "US",
        "latitude": 30.2687,
        "longitude": -97.7469,
        "phone": "+1 512-555-0142",
        "website": "https://mananacoffeeaustin.com",
        "rating": 4.6,
        "reviewCount": 1284,
        "priceLevel": "$$",
        "permanentlyClosed": false,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no"
      },
      {
        "placeId": "ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
        "cid": "5127740981263455000",
        "name": "Radio Coffee & Beer",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Bar"
        ],
        "address": "4204 Menchaca Rd, Austin, TX 78704, USA",
        "street": "4204 Menchaca Rd",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78704",
        "countryCode": "US",
        "latitude": 30.2277,
        "longitude": -97.7808,
        "phone": "+1 512-555-0187",
        "website": "https://radiocoffeeandbeer.com",
        "rating": 4.7,
        "reviewCount": 3021,
        "priceLevel": "$$",
        "permanentlyClosed": false,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHRadioCoffeeBeerPatio=w400-h300-k-no"
      },
      {
        "placeId": "ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
        "name": "Summer Moon Coffee",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop"
        ],
        "address": "1900 Aldrich St Ste 100, Austin, TX 78723, USA",
        "street": "1900 Aldrich St Ste 100",
        "city": "Austin",
        "state": "Texas",
        "postalCode": "78723",
        "countryCode": "US",
        "latitude": 30.296,
        "longitude": -97.7028,
        "website": "https://summermooncoffee.com",
        "rating": 4.5,
        "reviewCount": 642,
        "priceLevel": "$",
        "permanentlyClosed": false,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHSummerMoonAldrich=w400-h300-k-no"
      }
    ]
  }
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

一个请求，一种响应结构。

你发送的每个字段和收到的每个字段，都附有真实示例。

最近验证于 2026-11-14 · 可用率和延迟按 30d 统计

请求体

JSON，POST 到这个接口。

  • locationstring

    Austin, TX

    要搜索的地点，自由文本，最好是城市加国家（例如 Austin, USA）。

  • querystring

    coffee shop

    你会在 Google Maps 搜索栏中输入的内容（例如 coffee shop）。

  • categoryFilterWordsarray

    可选，要保留的 Google Maps 地点类别名称列表；结果仅限类别与其中之一匹配的地点。请使用 Google Maps 上显示的小写类别名称（例如 ["coffee shop", "restaurant"]）。省略则包含所有类别并保持最便宜的价格；类别筛选会路由到更贵的数据源。

  • languagestring

    结果使用的两字母语言代码（例如 en）。

  • limitinteger

    3

    最多返回的结果数（1-20，默认 20）。价格取决于所选服务商，可能按请求固定计费。

  • placeMinimumStarsenum

    仅返回平均评分不低于该值的地点：two（2+）、twoAndHalf（2.5+）、three（3+）、threeAndHalf（3.5+）、four（4+）或 fourAndHalf（4.5+）。没有评价的地点会被排除。省略此字段可保持最便宜的价格；设置最低评分会路由到更贵的数据源。

  • requireFieldsarray

    可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `cid` 或 `street`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个地点确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。

  • websiteenum

    按地点是否列出网站筛选：allPlaces（默认）、withWebsite（仅有网站的地点）或 withoutWebsite（仅没有网站的地点）。省略此字段或传入 allPlaces 可保持最便宜的价格；withWebsite 和 withoutWebsite 会路由到更贵的数据源。

你发送。 一个简短的 JSON 请求体。显示的值只是示例，请换成你自己的。

响应

JSON，每个字段一个示例值。

each itemdata.items[]

Matching Google Maps place records. Populated whenever the provider has data for the entity.

  • addressstring

    612 W 6th St, Austin, TX 78701, USA

    Full formatted street address.

  • categoriesstring[]

    Every Google Maps category listed for the place.

  • categorystring

    Coffee shop

    Primary place category (e.g. Coffee shop).

  • cidstring可设为必填

    8234917364550128200

    Google customer/place id (cid).

  • citystring可设为必填

    Austin

    City the place is in.

  • countryCodestring可设为必填

    US

    Two-letter country code.

  • hoursobject[]可设为必填

    Opening hours by day: each element is an object with the day name and its hours. null when the serving source does not return hours; name `hours` in `requireFields` to be served by one that does.

  • imagestring

    https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no

    Primary place photo URL.

  • latitudenumber

    30.2687

    Latitude of the place in decimal degrees.

  • longitudenumber

    -97.7469

    Longitude of the place in decimal degrees.

  • namestring

    Mañana Coffee House

    Place name. Populated whenever the provider has data for the entity.

  • permanentlyClosedboolean可设为必填

    false

    True when the place is marked permanently closed.

  • phonestring可设为必填

    +1 512-555-0142

    Business phone number in E.164 format, when listed.

  • placeIdstring

    ChIJrX7cX9C1RIYR2LFEjaLyeuY

    Google Maps place id (stable identifier for the place). Populated whenever the provider has data for the entity.

  • postalCodestring可设为必填

    78701

    Postal code of the place.

  • priceLevelstring可设为必填

    $$

    Relative price level indicator (e.g. $, $10-20).

  • ratingnumber

    4.6

    Average star rating out of 5.

  • reviewCountnumber

    1284

    Total number of reviews.

  • statestring可设为必填

    Texas

    State or region the place is in.

  • streetstring可设为必填

    612 W 6th St

    Street line of the address.

  • urlstring

    https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY

    Canonical Google Maps URL for the place. Populated whenever the provider has data for the entity.

  • websitestring

    https://mananacoffeeaustin.com

    The place's own website URL, when listed.

top level
  • foundboolean

    true

    True when the search returned at least one matching place.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

你收到。 字段有名称、有类型，无论哪个数据源响应，结构都一样。

你在出售这个 API？查看你的接口必须返回的完整数据结构。

常见问题

关于 Google Maps 搜索 API

AnyAPI 的 Google Maps 搜索 API 只需一次 POST 请求 /v1/run/maps.search，就以统一格式的 JSON 返回 Google Maps 数据。在 Google Maps 上搜索与查询词和地点匹配的地点：每次请求最多返回 20 条标准化地点记录，包含评分、地址和基本联系方式。AnyAPI 会在 6 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$1.50 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Google Maps 搜索 API 调用中有 100.0% 成功，响应时间中位数为 2.7 秒，共测量 63,111 次调用。

费用：每千次请求 US$1.50 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

在 Google Maps 上搜索与查询词和地点匹配的地点：每次请求最多返回 20 条标准化地点记录，包含评分、地址和基本联系方式。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 Google Maps 搜索 API 调用中有 100.0% 成功，响应时间中位数为 2.7 秒，共测量 63,111 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。

可以。新的 AnyAPI 账户自带 US$0.10 免费余额，无需绑卡，足够调用 66 次 Google Maps 搜索，每次 US$0.0015。

AnyAPI 会在同一个请求中依次尝试它的 6 个数据源，从最便宜的开始，所以一个数据源宕机不会让你的调用失败。

向 https://api.getanyapi.com/v1/run/maps.search 发送 POST 请求，在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥，并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元，每个请求从中扣费。没有月度套餐，也没有最低消费，同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk，Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口，任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器，或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥，再通过 HTTP 调用这个接口。
更多接口

Google Maps 的其他接口

联系方式/千次请求 US$3.25 起地点/千次请求 US$1.00 起评价/千条结果 US$0.0215 起搜索附近地点/千次请求 US$1.30 起