迁移 Places API 响应

新的地点详情 API、附近搜索 API 和文本搜索 API 的响应格式与现有 API 的格式已更改。主要区别在于每种方法返回的 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 新的 Place 对象中 photos 的格式已更改。如需了解详情，请参阅对照片引用的更改。
地点 ID place_id id
Plus Code plus_code plusCode
价格水平 price_level priceLevel
分级 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
资源名称 name 字段，格式为 places/PLACE_ID 在现有 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 对象
地点详情 包含现有 Place 对象的 result 新的Place对象
请求的状态 status 已移到标准 HTTP 响应（HTTP 响应代码和消息）
任何信息类消息 info_messages 已移到标准 HTTP 响应（HTTP 响应代码和消息）