Google Maps 地点 API

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

POST/v1/run/maps.place

可用率

100.00%

30d · 21,769 次调用

请求数

21,770

30d · 按周，近 12 周

响应时间

2.7s

中位数 · 30d

服务商网络

按流量排序的服务商

服务商调用占比

Lynx优先调用已服务 21,642可用率 100.00%2545ms p5099.4%99.4%100.00% (21,642 次调用)2545ms (21,642 次调用)21,642US$1.75/千次请求固定价

Meerkat已服务 100可用率 100.00%1569ms p500.5%0.5%100.00% (100 次调用)1569ms (100 次调用)100US$2.97/千次请求固定价

Octopus已服务 24可用率 100.00%17248ms p500.1%0.1%100.00% (24 次调用)17248ms (24 次调用)24US$4.95/千条结果每次请求最多 US$0.0099

试一试

发出你的第一个请求

query*string要查找的商家名称或搜索文本，就像你在 Google Maps 搜索栏中输入的那样（例如 Blue Bottle Coffee）。categoryFilterWordsarray可选，要保留的 Google Maps 地点类别名称列表；匹配结果仅限类别属于其中之一的地点。请使用 Google Maps 上显示的小写类别名称（例如 ["coffee shop"]）。省略则允许任何类别并保持最便宜的价格；类别筛选会路由到更贵的数据源。languagestring结果详情使用的两字母语言代码（例如 en）。locationstring可选，用于限定搜索范围的自由文本地点，最好是城市加州或国家（例如 San Francisco, CA）。会将查询缩小到该区域内的最佳匹配。placeMinimumStarsenum仅匹配平均评分不低于该值的地点：two（2+）、twoAndHalf（2.5+）、three（3+）、threeAndHalf（3.5+）、four（4+）或 fourAndHalf（4.5+）。没有评价的地点会被排除。省略此字段可保持最便宜的价格；设置最低评分会路由到更贵的数据源。

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

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

打开于提示词已复制

获取免费密钥

示例响应

免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

{
  "data": {
    "items": [
      {
        "address": "123 Main St",
        "categories": [
          "example"
        ],
        "category": "general",
        "city": "San Francisco",
        "countryCode": "US",
        "hours": [
          {}
        ],
        "image": "https://example.com/image.jpg",
        "latitude": 37.7749,
        "longitude": -122.4194,
        "name": "Example title",
        "neighborhood": "example",
        "permanentlyClosed": false,
        "phone": "+1 555-0142",
        "placeId": "a1b2c3d4",
        "plusCode": "a1b2c3d4",
        "postalCode": "94107",
        "priceLevel": "19.99",
        "rating": 4.6,
        "reviewsCount": 12500,
        "state": "CA",
        "street": "123 Main St",
        "url": "https://example.com/page",
        "website": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}

响应类型定义

interface MapsPlaceResponse {
  data: {
    items: {
      address?: string;
      categories?: string[];
      category?: string;
      city?: string;
      countryCode?: string;
      hours?: {
      }[];
      image?: string;
      latitude?: number;
      longitude?: number;
      name: string;
      neighborhood?: string;
      permanentlyClosed?: boolean;
      phone?: string;
      placeId?: string;
      plusCode?: string;
      postalCode?: string;
      priceLevel?: string;
      rating?: number;
      reviewsCount?: number;
      state?: string;
      street?: string;
      url: string;
      website?: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

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

参考

请求、响应与价格

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

POST /v1/run/maps.place

curl -X POST https://api.getanyapi.com/v1/run/maps.place \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"San Francisco, CA","query":"Blue Bottle Coffee"}'

字段	类型	示例值
请求体
query	string	"Blue Bottle Coffee"要查找的商家名称或搜索文本，就像你在 Google Maps 搜索栏中输入的那样（例如 Blue Bottle Coffee）。
categoryFilterWords	array	可选，要保留的 Google Maps 地点类别名称列表；匹配结果仅限类别属于其中之一的地点。请使用 Google Maps 上显示的小写类别名称（例如 ["coffee shop"]）。省略则允许任何类别并保持最便宜的价格；类别筛选会路由到更贵的数据源。
language	string	结果详情使用的两字母语言代码（例如 en）。
location	string	"San Francisco, CA"可选，用于限定搜索范围的自由文本地点，最好是城市加州或国家（例如 San Francisco, CA）。会将查询缩小到该区域内的最佳匹配。
placeMinimumStars	enum	仅匹配平均评分不低于该值的地点：two（2+）、twoAndHalf（2.5+）、three（3+）、threeAndHalf（3.5+）、four（4+）或 fourAndHalf（4.5+）。没有评价的地点会被排除。省略此字段可保持最便宜的价格；设置最低评分会路由到更贵的数据源。
requireFields	array	可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `hours` 或 `plusCode`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个地点确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
website	enum	按地点是否列出网站筛选：allPlaces（默认）、withWebsite（仅当其有网站时）或 withoutWebsite（仅当其没有网站时）。省略此字段或传入 allPlaces 可保持最便宜的价格；withWebsite 和 withoutWebsite 会路由到更贵的数据源。
响应
data	object
data.items	object[]	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.
data.items[].address	string	Full formatted street address. Populated whenever the provider has data for the entity.
data.items[].categories	string[]	Every Google Maps category listed for the place.
data.items[].category	string	Primary Google Maps category (e.g. Coffee shop). Populated whenever the provider has data for the entity.
data.items[].city可设为必填	string
data.items[].countryCode可设为必填	string	Two-letter country code.
data.items[].hours可设为必填	object[]	Opening hours by day: each element is an object with the day name and its hours.
data.items[].image	string	URL of the primary place photo.
data.items[].latitude	number	Populated whenever the provider has data for the entity.
data.items[].longitude	number	Populated whenever the provider has data for the entity.
data.items[].name	string	Business or place name. Populated whenever the provider has data for the entity.
data.items[].neighborhood可设为必填	string
data.items[].permanentlyClosed可设为必填	boolean	Whether the place is permanently closed.
data.items[].phone	string	Formatted phone number.
data.items[].placeId	string	Google Maps place id. Populated whenever the provider has data for the entity.
data.items[].plusCode可设为必填	string	Google Plus Code for the location.
data.items[].postalCode可设为必填	string
data.items[].priceLevel	string	Price level indicator (e.g. a price range).
data.items[].rating	number	Average star rating.
data.items[].reviewsCount	integer	Total number of reviews.
data.items[].state可设为必填	string	State or region name.
data.items[].street可设为必填	string	Street portion of the address.
data.items[].url	string	Google Maps URL for the place. Populated whenever the provider has data for the entity.
data.items[].website	string	Business website URL.
found	boolean
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.
价格
每次请求价格	USD	US$0.00175
价格（/千次请求）	USD	US$1.75

常见问题

关于 Google Maps 地点 API

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

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

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

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

更多接口

Google Maps 的其他接口

联系方式/千次请求 US$3.25 起评价/千次请求 US$3.50 起搜索/千次请求 US$1.75 起搜索附近地点/千次请求 US$1.30 起

一个密钥，一个钱包，
开始你的第一次 Google Maps 调用。

领取 ~150 次免费请求

Google Maps 地点 API

按流量排序的服务商

发出你的第一个请求

请求、响应与价格

关于 Google Maps 地点 API

Google Maps 地点 API 怎么收费？

Google Maps 地点 API 返回什么？

Google Maps 地点 API 的可靠性如何？

Google Maps 的其他接口

一个密钥，一个钱包，开始你的第一次 Google Maps 调用。

一个密钥，一个钱包，
开始你的第一次 Google Maps 调用。