迁移 Places API 响应

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

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

• 文本搜索响应变更
• 附近搜索结果响应变更
• “地点详情”响应更改

响应地点对象的更改

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

“地点详情”响应变更

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

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