01 · Context

各端直连地图能力,会同时丢掉安全与产品边界。

当地图帮从桌面工具扩展到在线制图与多端触点,地理编码、路径、POI 等能力如果各自对接上游,Key 泄露、计费失控、失败语义不一致会同时出现。更危险的是:把 API 控制台塞进普通用户工作台,权限模型与导航心智会一起崩坏。

开发者要的是契约、配额和可预期失败;普通用户要的是完成任务。两者不应共享同一个门户心智。

02 · Problem framing

问题不是“有没有 API 页面”,而是能力如何被正确地产品化。

常见做法我重新定义的问题产品价值
把内部已有服务原样暴露开发者任务到底是什么?按任务定义能力边界
控制台与制图站混在同一导航谁是第一用户?避免门户错位
多处各自记账扣减与退款以谁为准?单一权威账本
失败只返回“error”超时/重试/退款如何解释?可信的商业化底座
03 · Key decisions

平台产品的关键取舍。

DECISION 01

三层 API 边界

自有应用服务、开发者开放、内部管理分开。未登记接口不得宣传为开放 API。

DECISION 02

不是第二个用户门户

开发者五项导航服务契约与治理;普通制图与数据店面留在 Map Studio。

DECISION 03

账本权威唯一

用户中心可发起充值,消费与退款权威在真正处理调用与额度扣减的平台侧,避免双账本。

DECISION 04

按任务抽象,不按内部实现暴露

参数语义与返回结构面向开发者任务;上游凭据永不下发;失败按契约补偿。

04 · Product model

从资格到调用的治理链。

企业资格
创建 Key
授权接口范围
鉴权与扣减
代理上游 / 返回

产品层提供目录、文档、控制台与用量可见性;服务层负责鉴权链、计量与上游代理。Web / 桌面 / 未来 AI 工具调用可以共享同一治理模型,但当前对外能力以地理服务为主,不以“大模型 API 网关”对外宣传。

话术红线

不说“对外开放全部 API”;不把开放平台首页做成第二个 Map Studio。

05 · Business impact

平台价值如何向业务负责人解释。

L1 用户价值
获准开发者获得稳定契约与可理解的失败边界。
降低集成成本与误用风险。
L2 产品价值
自有各端通过统一服务消费地理能力。
减少重复对接与口径漂移。
L3 平台价值
授权、配额、计量、审计成为可迁移的治理底座。
为后续用量型商业化留结构,而非临时脚本。
L4 组织效率
产品、工程、运营对“什么叫开放”有同一套定义。
减少跨端扯皮与安全事故面。
06 · Evidence

可检查的产品证据,而不是漂亮曲线。

产品原型与接口目录

接口目录、文档、控制台(Key / 用量 / 调试)等演示页面,可用于对照平台的信息架构。

边界文档化

产品方案明确三层边界、账本权威与“非第二门户”红线。

多端消费关系

与 Map Studio、桌面端、用户中心的职责表可核对,而不是口头“中台”。

指标红线

日/月调用量、活跃 Key、充值消耗比等经营指标待核验,本页不填写、不估算。

07 · Reflection

平台产品首先是边界产品。

GeoAPI 训练我的是:在商业化压力下仍守住“对谁开放、开放什么、如何计量、失败怎么办”。没有边界的开放,只是把内部复杂度外包给开发者。

若重做,我会更早把开发者成功路径(首调成功时间、鉴权失败可理解率)做成验收指标,并在核对统计口径后分享实际效果。