Method: places.searchNearby

搜索位置附近的地点。

HTTP 请求

POST https://places.googleapis.com/v1/places:searchNearby

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "languageCode": string,
  "regionCode": string,
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ],
  "maxResultCount": integer,
  "locationRestriction": {
    object (LocationRestriction)
  },
  "rankPreference": enum (RankPreference),
  "routingParameters": {
    object (RoutingParameters)
  },
  "includeFutureOpeningBusinesses": boolean
}
字段
languageCode

string

如果地点详情有首选语言版本，系统会以该语言显示。如果未指定或无法识别语言代码，则可能会返回任何语言的地点详细信息，但如果存在英语详细信息，则优先返回英语详细信息。

如需查看当前支持的语言列表，请访问 https://developers.google.com/maps/faq#languagesupport。
regionCode

string

请求来源地的 Unicode 国家/地区代码 (CLDR)。此参数用于显示地点详情，例如特定于区域的地点名称（如果有）。此参数可能会根据适用法律影响结果。

如需了解详情，请参阅 https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html。

请注意，目前不支持 3 位数的地区代码。
includedTypes[]

string

来自 https://developers.google.com/maps/documentation/places/web-service/place-types 的包含地点类型（例如“餐厅”或“加油站”）。

最多可以指定 表 A 中的 50 种类型。

如果存在任何冲突的类型（即某个类型同时出现在 includedTypes 和 excludedTypes 中），则系统会返回 INVALID_ARGUMENT 错误。

如果指定了地点类型并设置了多个类型限制，则系统只会返回满足所有限制的地点。例如，如果我们有 {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}，则返回的地点提供与“餐厅”相关的服务，但主要不是作为“餐厅”运营的。
excludedTypes[]

string

排除的地点类型（例如“餐厅”或“加油站”），请参阅 https://developers.google.com/maps/documentation/places/web-service/place-types。

最多可以指定 表 A 中的 50 种类型。

如果客户端同时提供 includedTypes（例如餐厅）和 excludedTypes（例如咖啡馆），则响应应包含餐厅但不包含咖啡馆。响应中包含的地点必须符合以下条件：至少属于一个 includedTypes，且不属于任何 excludedTypes。

如果存在任何冲突的类型（即某个类型同时出现在 includedTypes 和 excludedTypes 中），则系统会返回 INVALID_ARGUMENT 错误。

如果指定了地点类型并设置了多个类型限制，则系统只会返回满足所有限制的地点。例如，如果我们有 {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}，则返回的地点提供与“餐厅”相关的服务，但主要不是作为“餐厅”运营的。
includedPrimaryTypes[]

string

来自 https://developers.google.com/maps/documentation/places/web-service/place-types 的主要地点类型（例如“餐厅”或“加油站”）。一个地点只能有一个与支持的类型表相关联的主要类型。

最多可以指定 表 A 中的 50 种类型。

如果存在任何冲突的主要类型（即某个类型同时出现在 includedPrimaryTypes 和 excludedPrimaryTypes 中），则系统会返回 INVALID_ARGUMENT 错误。

如果指定了地点类型并设置了多个类型限制，则系统只会返回满足所有限制的地点。例如，如果我们有 {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}，则返回的地点提供与“餐厅”相关的服务，但主要不是作为“餐厅”运营的。
excludedPrimaryTypes[]

string

从 https://developers.google.com/maps/documentation/places/web-service/place-types 中排除的主要地点类型（例如“餐厅”或“加油站”）。

最多可以指定 表 A 中的 50 种类型。

如果存在任何冲突的主要类型（即某个类型同时出现在 includedPrimaryTypes 和 excludedPrimaryTypes 中），则系统会返回 INVALID_ARGUMENT 错误。

如果指定了地点类型并设置了多个类型限制，则系统只会返回满足所有限制的地点。例如，如果我们有 {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]}，则返回的地点提供与“餐厅”相关的服务，但主要不是作为“餐厅”运营的。
maxResultCount

integer

页面中结果的数量上限。必须介于 1 到 20 之间（含边界值）。如果未设置该数量，系统会回退到上限。如果该数字设置为负数或超出上限，系统会返回 INVALID_ARGUMENT 错误。
locationRestriction

object (LocationRestriction)

必需。要搜索的区域。
rankPreference

enum (RankPreference)

响应中结果的排名方式。
routingParameters

object (RoutingParameters)

可选。影响搜索结果路由的参数。
includeFutureOpeningBusinesses

boolean

可选。如果为 true，则包含尚未开业但未来会开业的商家。

响应正文

“附近搜索”的响应 proto。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "places": [
    {
      object (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ]
}
字段
places[]

object (Place)

满足用户要求的地点列表，例如地点类型、地点数量和特定位置限制。
routingSummaries[]

object (RoutingSummary)

一个路线摘要列表，其中每个条目都与 places 字段中相同索引处的相应地点相关联。如果某个地点的路线摘要不可用，则该地点对应的条目将为空。如果请求了此列表，则此列表应包含与地点列表相同数量的条目。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

LocationRestriction

要搜索的区域。

JSON 表示法 
{

  // Union field type can be only one of the following:
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
字段

联合字段 type。

type 只能是下列其中一项：
circle

object (Circle)

由中心点和半径定义的圆。

RankPreference

响应中结果的排名方式。

枚举
RANK_PREFERENCE_UNSPECIFIED 未设置 RankPreference 值。默认情况下，将按“POPULARITY”使用排名。
DISTANCE 按距离对结果进行排名。
POPULARITY 按热门程度对结果进行排名。