新
地点详情
附近搜索、
和
文本搜索
现有 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 响应代码和消息) |