TomTom Orbis Fuzzy Search API

TomTom 官方 Orbis Fuzzy Search 以 GET 检索地址/地名/POI，需服务API key及版本参数或header；文档标为Public Preview并建议新集成评估Places Search，本次未调用。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：模糊地址、地名与兴趣点检索 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · e1b8ba35ee6ec4dbbace16f002b1e1e8c68d9430ddb0910514d064715d835f37

本次官方页面给出Orbis路径 /maps/orbis/places/search/{query}.{ext}，示例主机api.tomtom.com，使用GET并要求有效服务key。query需URL编码，可配预测输入、国家、位置偏好/硬范围、语言和POI属性筛选。JSON返回summary和按score降序的results；实际字段随结果类型与可用数据变化。该页明确Public Preview，本文只登记此已捕获版本，不把它当作所有TomTom搜索产品统一接口。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-7841f1b5656e749cf45eeabc · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-7841f1b5656e749cf45eeabc
名片版本: 2
资料更新: 2026-10-24T18:35:27.2431613+00:00
原作者 / 提供者: 未知
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

URL编码query，响应ext可json/jsonp/js/xml；必填服务key，版本由apiVersion或TomTom-Api-Version指定。
可选typeahead默认false；limit默认10、最多100；countrySet国家范围。
geobias偏好排序与lat/lon/radius、topLeft/btmRight硬范围条件不同，按文档组合。
可选language、idxSet、categorySet、brandSet及充电/燃料等POI筛选。

输出

JSON主结构summary与results；summary可含query/queryTime/numResults/totalResults等。
结果按score降序，可含type、id、poi、address、position、viewport、入口点或其他数据字段。
实际字段取决于结果类型及数据存在性，不保证示例全部字段每次齐全。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：API 密钥。请求key参数必须为对该服务有效的API key，凭据由使用者自行提供；本次未申请或使用实际key。

运行前提

取得对所选Orbis服务有效的API key，由使用者自行提供。
将query正确URL编码，选择响应ext；apiVersion查询参数与TomTom-Api-Version header至少一个必须存在，本文版本值为1。
按具体区域/内容条件选择支持的baseURL；本文列api.tomtom.com及kr-api.tomtom.com，未核地域覆盖页。

公开请求示例

{
  "credential_requirement": "\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\u6709\u6548\u670D\u52A1API key",
  "documentation_text": "\u5B98\u65B9\u793A\u4F8B\u8DEF\u5F84\uFF08\u672A\u6267\u884C\uFF09\uFF1AGET https://api.tomtom.com/maps/orbis/places/search/123%20main%20st.json\uFF0C\u4F7F\u7528apiVersion=1\uFF1B\u5FC5\u586Bkey\u51ED\u636E\u7531\u4F7F\u7528\u8005\u81EA\u884C\u63D0\u4F9B\uFF0C\u4E0D\u5728\u793A\u4F8B\u5199\u503C\u3002",
  "method": "GET",
  "query_parameters": {
    "apiVersion": "1"
  },
  "url": "https://api.tomtom.com/maps/orbis/places/search/123%20main%20st.json"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。本次端点文档未给绝对价格、免费层或账户配额；只说明超过key的QPS会返回429，具体QPS未确认。

价格来源 · 未知

资料去向

提供者服务器。地址、地名、坐标偏好、筛选及认证key提交到TomTom托管服务；区域内容与实际数据保存/驻留条件未在本次读取范围确认。

限制

文档标为Public Preview，且对新集成推荐Places Search；本文未读取该另一产品页面。
位置偏好不等于硬过滤；多个位置条件存在优先级，不能简单当同义参数。
页面将部分旧分页/模糊度参数标为deprecated并列历史计划退出日期，本项不采用这些旧参数。
模板段还出现query仅坐标的限定文字，与地址示例并列；本次未调用验证具体输入边界。
超过key的QPS可返回429，但本页未给实际账户每秒额度。
未查询地址/POI、申请key或验证地区/时效。

仍需核对

实际key权限、地区覆盖及Public Preview账户条件未知。
价格、免费额度、具体QPS/配额未知。
query模板限定与地址示例的实际行为未验证。
结果覆盖、精度、时效及具体字段存在性未知。
数据保留/驻留与完整地图数据使用条款未确认。
未请求端点或使用真实key。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:34:24.2052249+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Fuzzy Search | Orbis Search API · 官方文档 · 2026-10-24T18:34:24.2052249+00:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://docs.tomtom.com/search-api/documentation/tomtom-orbis-maps/search-service/fuzzy-search",
  "final_url": "https://docs.tomtom.com/search-api/documentation/tomtom-orbis-maps/search-service/fuzzy-search",
  "status_code": 200,
  "title": "Fuzzy Search | Orbis Search API",
  "description": "Public Preview Notice",
  "checked_at": "2026-10-24T18:34:24.2052249\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-7841f1b5656e749cf45eeabc",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://docs.tomtom.com/search-api/documentation/tomtom-orbis-maps/search-service/fuzzy-search"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。