迁移 Places API 响应

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

此外，响应对象的顶级字段还具有 更改。请参阅：

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

对响应 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 对象的 results 数组	新的 places 数组 Place对象
请求状态	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 响应代码和消息）