迁移 Places API 响应

新版 Place Details、Nearby Search 和 Text Search API 的响应格式已与现有 API 的格式不同。主要区别在于每个方法返回的 Place 对象的格式，如对响应地点对象的更改中所述。

此外，每个 API 的响应对象的顶级字段也已更改。请参阅：

响应地点对象的更改

下表显示了“地点详情（新）”“附近搜索（新）”和“文本搜索（新）”响应中新 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
资源名称 格式为 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 对象中，以 place.attributions 的形式存在
地点数组 现有地点对象的 results 数组 新 Place 对象的 places 数组
请求的状态 status 改用标准 HTTP 响应（HTTP 响应代码和消息）
所有错误消息 error_message 改用标准 HTTP 响应（HTTP 响应代码和消息）
任何信息消息 info_messages 已移除
页面令牌 next_page_token 已移除

“附近搜索”响应变更

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

字段 附近搜索（现有） 附近搜索（新） 备注
地点归因 html_attributions 已移至每个地点的新 Place 对象中，以 place.attributions 的形式存在
地点数组 现有地点对象的 results 数组 新 Place 对象的 places 数组
请求的状态 status 改用标准 HTTP 响应（HTTP 响应代码和消息）
所有错误消息 error_message 改用标准 HTTP 响应（HTTP 响应代码和消息）
任何信息消息 info_messages 已移除
页面令牌 next_page_token 已移除

“地点详情”响应变更

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

字段 地点详情（现有） 地点详情（新） 备注
地点归因 html_attributions 作为 attributions 移入了新的地点对象
地点详情 包含现有地点对象的 result 新的 Place 对象
请求的状态 status 改用标准 HTTP 响应（HTTP 响应代码和消息）
任何信息消息 info_messages 改用标准 HTTP 响应（HTTP 响应代码和消息）