按名称搜索餐厅所在地与餐饮场所
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →根据用户输入的名称,通过必填的 query 字符串参数查询餐饮地点建议。传入城市、区域名称,或餐厅名称的一部分,即可读取返回的地点记录,方便餐厅类界面让用户选定目标位置。该参数的文档说明是餐厅所在地点的名称。此操作只返回建议记录:不返回餐厅详情、菜单、营业时间、评价或预订信息,也不接受筛选、语言或分页输入。 该操作没有提供已观测的探测响应,响应说明来自被截断的源示例,尚未经过验证。以查询词 mumbai 为例,示例中的 data 数组由地点对象组成,字段包括 documentId、locationId、isGeo、localizedName、placeType、latitude、longitude、localizedAdditionalNames.longOnlyHierarchy、locationV2(含 names.longOnlyHierarchyTypeaheadV2、placeType,以及要么是带 url 的对象、要么为 null 的 vacationRentalsRoute)、streetAddress.street1,以及 thumbnail.photoSizeDynamic 对象(含 maxHeight、maxWidth 和带有 {width}、{height} 占位符的 urlTemplate)。第一条示例记录是城市 Mumbai,isGeo 为 true、placeType 为 CITY;其余可见记录的 isGeo 为 false、placeType 为 EATERY,例如印度尼西亚的 Mumbai Kitchen 和西班牙的多家 Mumbai Masala 分店,因此一次响应里可能同时混有地区记录和单个餐厅记录。示例在中途被截断,完整的结果数量、排序方式、data 之外的外层字段以及错误行为均无法确定。请把名称标签当作展示文本,使用任何字段之前先检查实际返回结果,并且不要想当然地认为 locationId 或 documentId 可以直接作为 restaurantsId 传给其他操作,务必先查阅那个操作自身的输入文档。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/search-restaurant-location API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-restaurant-location?key=<API_KEY>&query=<query>'
查询结果
使用场景
- 搭建餐厅搜索框,在旅客输入 mumbai 时联想匹配的城市和餐厅名称,并在 localizedName 下方显示 longOnlyHierarchy 一行层级文字。
- 按 placeType 和 isGeo 对选择器分流:选中 CITY 建议时进入区域级餐饮页面,选中 EATERY 建议时进入单个餐厅页面。
- 确认实际响应中经纬度都存在之后,再根据 latitude 和 longitude 把建议的餐厅标注到预览地图上。
- 用 urlTemplate 生成缩略图,再配合 streetAddress.street1 一行地址渲染建议列表,让用户分清位于不同国家的同名餐厅。
- 用多个不同的输入词取样并保存原始建议记录,研究连锁或通用名称在各国是如何分散的,然后再决定把哪个存储标识接入餐厅详情请求。
常见问题
query 参数应该传什么?
传入餐厅所在地点的名称,例如 mumbai 这样的城市名。该参数是必填字符串。此操作没有其他输入,因此不支持筛选、语言、结果数量限制和分页。
这个接口返回的是餐厅,还是只有城市?
针对 mumbai 的源示例两者都有。第一条记录是城市 Mumbai(placeType 为 CITY,isGeo 为 true),其余可见记录是餐厅(placeType 为 EATERY,isGeo 为 false),名称如 Mumbai Kitchen。由于示例被截断且没有提供探测响应,其他查询词的具体构成无法确定,请在代码中根据 placeType 和 isGeo 分支处理。
文档记载了哪些响应字段?
被截断的源示例显示 data 数组,其中的对象包含 documentId、locationId、isGeo、localizedName、placeType、latitude、longitude、localizedAdditionalNames.longOnlyHierarchy、locationV2、streetAddress.street1 和 thumbnail.photoSizeDynamic。由于没有提供已观测的探测响应,这些字段尚未验证,示例在可见记录之后也被截断。
返回的 locationId 能直接当作 restaurantsId 用于餐厅详情操作吗?
不要想当然。餐厅详情类操作的文档确实把 restaurantsId 列为输入,但现有证据并没有表明这里返回的 locationId 或 documentId 会被它们接受,也没有说明应采用什么形式。在围绕它搭建流程之前,请查阅目标操作的输入文档,并用一个真实返回值实际测试。
如何把缩略图的 urlTemplate 变成可用的图片地址?
示例中的 urlTemplate 含有字面的 {width} 和 {height} 占位符。请把它们替换成适合版式的像素尺寸,并保持在模板旁 maxWidth 与 maxHeight 的范围内。生成的地址只是展示内容,请兼容没有缩略图的记录。
这个接口会返回菜单、营业时间或评价吗?
不会。它只是地点和场所的建议查询。文档记载的响应字段只涉及名称、层级标签、经纬度、街道行和缩略图模板。如需更丰富的餐厅内容,请使用专门的餐厅详情操作,并查看它自己的输入和响应说明。