接口申请与上线准备
优先申请一个街道级数据源和一个地图浏览器 AK,即可完成核心流程。普通城市级接口用于对比;无需一次申请全部服务。以下信息依据供应商官方资料整理,核对日期:2026 年 11 月 4 日。
| 服务与优先级 | 需要申请什么 | 作用与精度 | 准备交付 |
|---|---|---|---|
| 埃文科技 IP问问 核心,二选一 | IPv4 归属地 API 的街道级产品权限与测试额度;当前官网街道级版本需咨询客服,适用资格需由供应商确认。 | 候选位置、多区域经纬度、半径、行政区和运营商。高精度主要覆盖中国内地;不保证每个 IP 达到街道。 | 产品私 Key、授权版本、每日额度、样本响应、是否允许网站展示和缓存。 |
| IP 数据云 核心,二选一;可作第二来源 | IP 归属地街道级 API,明确是有 street / multi_street 字段的产品。 | 省市区、街道、历史候选区域和经纬度。能否到街道取决于套餐、IP 覆盖和数据更新。 | 产品 Key、套餐精度、坐标系、半径单位、实际 JSON 响应、QPS 与日额度。 |
| 百度地图开放平台 地图必需 | 创建浏览器类型应用,开通 JavaScript API;确认网站地图展示所需的技术服务 / 商用授权。 | 底图、位置点与半径圆。地图能力本身不提高 IP 定位精度。 | 浏览器 AK;Referer 白名单填 d.pdmshub.com,按控制台要求覆盖测试地址。 |
| 腾讯位置服务 可选 | WebService API 的 IP 定位权限。 | 国家至区县,坐标通常为行政区参考点,不能用普通接口实现街道定位。 | 服务端 Key、WebService 权限;若设置 IP 白名单,加入 47.99.207.20。 |
| 高德地图普通 IP 定位 可选 | Web 服务类型 Key,普通 IP 定位权限。 | 国内 IPv4 城市范围;高级 IP 定位是另一项商务服务,当前未接入。 | 服务端 Key、调用配额;服务器 IP 白名单同上。 |
| 百度普通 IP 定位 可选 | 另建服务端应用 AK,与浏览器 AK 分开。 | 城市级参考点;普通定位接口不能保证街道级。 | 服务端 AK、IP 白名单、配额。 |
| DB-IP City Lite 基础服务 | 免费离线库;无需申请 Key。 | 全球近似城市信息,不含街道。月度更新,页面保留来源署名。 | 由部署维护人员更新数据库即可。 |
向街道级服务商发送的需求
我们准备在自有企业网站中输入公网 IP,展示地理归属、街道、多候选区域、经纬度、定位精度和置信 / 覆盖半径。请确认适用企业资格,提供街道级 API 测试 Key、接口文档、真实样本响应、坐标系、半径单位、测试及正式配额、QPS、查空扣费规则,以及对网站展示、缓存和数据导出的授权条件。服务器出口 IP 为 47.99.207.20,网站域名为 d.pdmshub.com。希望先通过授权测试样本评估,再选择套餐。
实际调用的接口
埃文:https://api.ipplus360.com/ip/geo/v1/street/psi/,参数 key, ip, coordsys=BD09, area=multi。
IP 数据云:https://api.ipdatacloud.com/v2/query,参数 key, ip。
腾讯:https://apis.map.qq.com/ws/location/v1/ip。高德:https://restapi.amap.com/v3/ip。百度:https://api.map.baidu.com/location/ip。
网站通过自建后端调用这些接口。服务端密钥不发送到浏览器;浏览器地图 AK 按地图平台规则限制域名。
拿到授权后的接入顺序
- 将密钥配置到服务器的受限环境文件,重启查询服务。
- 通过供应商提供的测试 IP 核验字段、坐标系、半径单位和实际精度。
- 用有已知位置且获准使用的企业网络样本,分别检查固定宽带、移动出口和机房 IP。
- 配置地图 AK 的域名授权,核验点位与覆盖圆;设置查询访问码、每日预算与正式配额。
街道级套餐也可能返回城市级结果。逆地理编码只能把已有坐标翻译成地址,无法把城市参考点变成真实街道定位。多个数据库的交叉结果也不能单独推导出更高精度。
价格、资格和服务授权以申请时的官方回复为准。尚未拿到付费 Key 的适配器需要真实联调,页面的“待接入”不代表服务已开通。