迁移 Places API 响应

与现有 API 的格式不同，新的地点详情、附近搜索和文本搜索 API 的响应格式已更改。主要区别在于每个方法返回的 Place 对象的格式，如响应 Place 对象的更改中所述。

此外，响应对象的顶级字段也针对每个 API 发生了变化。请参阅：

对响应 Place 对象的更改

下表显示了与现有 Place 对象相比，“地点详情（新）”“附近搜索（新）”和“文本搜索（新）”响应中新 Place 对象的变化。

新的响应对象对字段名称采用驼峰式大小写形式，包含新字段，并对部分现有字段进行了重命名。

字段 现有 Place 对象 新建 Place 对象 备注
地址组件 address_components addressComponents
地点微格式地址 adr_address adrFormatAddress
商家状态 business_status businessStatus
下周的营业时间 current_opening_hours currentOpeningHours
编辑摘要 editorial_summary editorialSummary
设置了格式的地址 formatted_address formattedAddress
国内电话号码 formatted_phone_number nationalPhoneNumber
位置 geometry.location location
视口 geometry.viewport viewport
地点出处 html_attributions attributions 现有 API 中响应的顶级字段
图标网址 icon 已移除。使用 iconMaskBaseUri 和 iconBackgroundColor。如需了解详情，请参阅地点图标。
图标背景颜色 icon_background_color iconBackgroundColor
图标遮罩网址 icon_mask_base_uri iconMaskBaseUri
国际电话号码 international_phone_number internationalPhoneNumber
文本地点名称 name displayName 文本地点名称现在可以通过 displayName.text 访问，以及 language 作为 displayName.languageCode 访问
营业时间 opening_hours regularOpeningHours
相册 photos photos photos 的格式在新的 Place 对象中已更改。如需了解详情，请参阅对照片引用的更改。
地点 ID place_id id
Plus Code plus_code plusCode
价格水平 price_level priceLevel
Rating rating rating
评价 reviews reviews
自今日起下周的辅助营业时间（例外情况和所有其他数据除外） secondary_opening_hours currentSecondaryOpeningHours
地点类型 types types
该地点的 Google 地图网址 url googleMapsUri
用户评分数量 user_ratings_total userRatingCount
UTC 时差 utc_offset utcOffsetMinutes
地址的简短形式，包括街道名称和城镇 vicinity shortFormattedAddress
地点网站 website websiteUri
轮椅通道信息 wheelchair_accessible_entrance accessibilityOptions wheelchair_accessible_entrance现在位于 accessibilityOptions.wheelchairAccessibleEntrance
地点属性 takeout, delivery, dine_in, curbside_pickup, reservable, serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine, serves_brunch, serves_vegetarian_food takeout, delivery, dineIn, curbsidePickup, reservable, servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine, servesBrunch, servesVegetarianFood
资源名称 格式为 places/PLACE_ID 的“name”字段 在现有 API 中，name 字段包含以文本字符串表示的地点名称。在新 API 中，该信息位于 displayName 中。
地点主要类型 primaryTypeName 新
将主要类型设置为文本字符串 primaryTypeDisplayName 新
常规每周二级营业时间，但有例外情况和所有其他数据 regularSecondaryOpeningHours 新
此地点接受的付款方式 paymentOptions 新
地点停车选项 parkingOptions 新
与该地点相关的子目的地列表 subDestinations 新
有关加油站燃料选项的最新信息 fuelOptions 新
某个地点的电动汽车充电信息 evChargeOptions 新
地点属性 outdoorSeating, liveMusic, menuForChildren, servesCocktails, servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom, goodForGroups, goodForWatchingSports 新

文本搜索响应变更

下表显示了对现有文本搜索的响应对象和文本搜索（新）响应对象的顶级字段所做的更改。对于新 API，响应中的唯一顶级字段是 places 数组。

字段 文本搜索（现有） 文本搜索（新） 备注
地点出处 html_attributions 已作为 place.attributions 移入每个地点的新 Place 对象
地点数组 现有 Place 对象的 results 数组 新 Place 对象的 places 数组
请求状态 status 已移至标准 HTTP 响应（HTTP 响应代码和消息）
所有错误消息 error_message 已移至标准 HTTP 响应（HTTP 响应代码和消息）
任何信息类消息 info_messages 移除内容
页面令牌 next_page_token 移除内容

“附近搜索”响应更改

下表显示了对现有“附近搜索”（新）的响应对象和响应对象的顶级字段所做的更改。对于新 API，响应中的唯一顶级字段是 places 数组。

字段 附近搜索（现有） 附近搜索（新） 备注
地点出处 html_attributions 已作为 place.attributions 移入每个地点的新 Place 对象
地点数组 现有 Place 对象的 results 数组 新 Place 对象的 places 数组
请求状态 status 已移至标准 HTTP 响应（HTTP 响应代码和消息）
所有错误消息 error_message 已移至标准 HTTP 响应（HTTP 响应代码和消息）
任何信息类消息 info_messages 移除内容
页面令牌 next_page_token 移除内容

“地点详情”响应更改

下表显示了现有地点详情的响应对象的顶级字段以及地点详情（新）的响应对象的顶级字段变更。对于新 API，响应中的唯一顶级字段是 places 数组。

字段 地点详情（现有） 地点详情（新） 备注
地点出处 html_attributions 已作为 attributions 移至新的 Place 对象
地点详情 result，包含现有 Place 对象 新的 Place 对象
请求状态 status 已移至标准 HTTP 响应（HTTP 响应代码和消息）
任何信息类消息 info_messages 已移至标准 HTTP 响应（HTTP 响应代码和消息）