SuperAPI AI 工具集

local-place-search

通用与其它

查看项目

更新于 10-15 17:29

技能介绍

用途:该接口在 Brave 的地理索引中检索现实世界地点,包括商户、兴趣点(POI)、街道地址、城市和街道,适合地图探索、附近功能与旅行规划等场景。它独立可用,无需先做网页搜索获取 POI ID。

主要能力:支持按自由文本查询(如 coffee shops)配合坐标或地点字符串检索;也可省略查询,仅按坐标浏览区域内通用 POI。返回结果按桶组织:results(POI)、cities、countries、regions、neighborhoods、addresses、streets,以及描述排序的 mixed。POI 字段含标题、URL、描述、坐标、邮政地址、电话、邮箱、评分与评论数、营业时间、类别、价格区间、菜系、距离、缩略图、外部档案、时区等。

使用方式:GET https://api.search.brave.com/res/v1/local/place_search,认证用 X-Subscription-Token 头。可用 latitude+longitude 或 location 字符串定位;radius 为米制半径偏置(非硬截断);count 默认 20,范围 1–100;另有 geoloc、country、search_lang、ui_lang、units、safesearch、spellcheck 等参数。若 q、坐标、location 三者全缺,返回 HTTP 422。results 中的 id 有效期约 8 小时,可传给 local-pois 与 local-descriptions 获取更丰富详情。

限制:该接口只找地点而非网页,通用信息检索应使用网页搜索;省略定位时结果来自全球,精度可能较低;地址类查询可能占满 count 预算,导致 results 为空而匹配集中在 addresses/streets;radius 无上限但并非硬性边界。API Key 需在 https://api.search.brave.com 获取,订阅信息见官方仪表盘。