Google Maps API

Google Maps 地点 API

按名称或搜索词在 Google Maps 上查找地点(可限定在某个地点范围内),以标准化 JSON 返回最匹配的地点及其可用的地址、联系方式、评分和坐标信息。

US$1.00/千次请求,按请求付费,无需订阅。

Blue Bottle Coffee - Google Maps
google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo
DirectionsSaveNearbySend to phoneShare

Blue Bottle Coffee

4.4(2,937)·Coffee shop

66 Mint St, San Francisco, CA 94103, USA
Open · Monday 6:30 AM-6:00 PM
+1 415-555-0118
bluebottlecoffee.com
OverviewReviewsAbout
API 返回的内容items[0]
{
"name": "Blue Bottle Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
"placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
"address": "66 Mint St, San Francisco, CA 94103, USA",
"street": "66 Mint St",
"city": "San Francisco",
"state": "California",
"postalCode": "94103",
... 还有 15 个字段
}
可用率
100.00%
30d · 150,371 次调用
请求数
150,391
30d · 按周,近 12 周
响应时间
2.5s
中位数 · 30d

试一试

一个请求获取 Google Maps 地点

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

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

{
  "found": true,
  "data": {
    "items": [
      {
        "name": "Blue Bottle Coffee",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
        "placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
        "address": "66 Mint St, San Francisco, CA 94103, USA",
        "street": "66 Mint St",
        "city": "San Francisco",
        "state": "California",
        "postalCode": "94103",
        "countryCode": "US",
        "neighborhood": "SoMa",
        "phone": "+1 415-555-0118",
        "website": "https://bluebottlecoffee.com",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Cafe",
          "Espresso bar"
        ],
        "rating": 4.4,
        "reviewsCount": 2937,
        "latitude": 37.7825,
        "longitude": -122.4058,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no",
        "priceLevel": "$$",
        "plusCode": "QHGX+59 San Francisco, California",
        "permanentlyClosed": false,
        "hours": [
          {
            "day": "Monday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Tuesday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Wednesday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Thursday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Friday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Saturday",
            "hours": "7:00 AM-6:00 PM"
          },
          {
            "day": "Sunday",
            "hours": "7:00 AM-5:00 PM"
          }
        ]
      }
    ]
  }
}

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

参考

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

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

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

请求体

JSON,POST 到这个接口。

  • querystring

    Blue Bottle Coffee

    要查找的商家名称或搜索文本,就像你在 Google Maps 搜索栏中输入的那样(例如 Blue Bottle Coffee)。

  • categoryFilterWordsarray

    可选,要保留的 Google Maps 地点类别名称列表;匹配结果仅限类别属于其中之一的地点。请使用 Google Maps 上显示的小写类别名称(例如 ["coffee shop"])。省略则允许任何类别并保持最便宜的价格;类别筛选会路由到更贵的数据源。

  • languagestring

    结果详情使用的两字母语言代码(例如 en)。

  • locationstring

    San Francisco, CA

    可选,用于限定搜索范围的自由文本地点,最好是城市加州或国家(例如 San Francisco, CA)。会将查询缩小到该区域内的最佳匹配。

  • placeMinimumStarsenum

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

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.

  • websiteenum

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

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

响应

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

each itemdata.items[]

The best-matching place for the query, with available address, contact, category, rating, opening-hours, and coordinate details. Up to one element (empty when nothing matched). Populated whenever the provider has data for the entity.

  • addressstring

    66 Mint St, San Francisco, CA 94103, USA

    Full formatted street address. Populated whenever the provider has data for the entity.

  • categoriesstring[]

    Every Google Maps category listed for the place.

  • categorystring

    Coffee shop

    Primary Google Maps category (e.g. Coffee shop). Populated whenever the provider has data for the entity.

  • citystring可设为必填

    San Francisco

  • countryCodestring可设为必填

    US

    Two-letter country code.

  • hoursobject[]

    Opening hours by day: each element is an object with the day name and its hours.

  • imagestring

    https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no

    URL of the primary place photo.

  • latitudenumber

    37.7825

    Populated whenever the provider has data for the entity.

  • longitudenumber

    -122.4058

    Populated whenever the provider has data for the entity.

  • namestring

    Blue Bottle Coffee

    Business or place name. Populated whenever the provider has data for the entity.

  • neighborhoodstring可设为必填

    SoMa

  • permanentlyClosedboolean可设为必填

    false

    Whether the place is permanently closed.

  • phonestring

    +1 415-555-0118

    Formatted phone number.

  • placeIdstring

    ChIJd7DoQL2AhYARW-mNQFPuGZo

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

  • plusCodestring可设为必填

    QHGX+59 San Francisco, California

    Google Plus Code for the location.

  • postalCodestring可设为必填

    94103

  • priceLevelstring

    $$

    Price level indicator (e.g. a price range).

  • ratingnumber

    4.4

    Average star rating.

  • reviewsCountinteger

    2937

    Total number of reviews.

  • statestring可设为必填

    California

    State or region name.

  • streetstring可设为必填

    66 Mint St

    Street portion of the address.

  • urlstring

    https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo

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

  • websitestring

    https://bluebottlecoffee.com

    Business website URL.

top level
  • foundboolean

    true

  • 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.

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

常见问题

关于 Google Maps 地点 API

AnyAPI 的 Google Maps 地点 API 只需一次 POST 请求 /v1/run/maps.place,就以统一格式的 JSON 返回 Google Maps 数据。按名称或搜索词在 Google Maps 上查找地点(可限定在某个地点范围内),以标准化 JSON 返回最匹配的地点及其可用的地址、联系方式、评分和坐标信息。AnyAPI 会在 4 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$1 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Google Maps 地点 API 调用中有 100.0% 成功,响应时间中位数为 2.5 秒,共测量 150,371 次调用。

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

按名称或搜索词在 Google Maps 上查找地点(可限定在某个地点范围内),以标准化 JSON 返回最匹配的地点及其可用的地址、联系方式、评分和坐标信息。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。

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

可以。新的 AnyAPI 账户自带 US$0.10 免费余额,无需绑卡,足够调用 100 次 Google Maps 地点,每次 US$0.001。

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

向 https://api.getanyapi.com/v1/run/maps.place 发送 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 调用这个接口。