@tianditu/services 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Demo Macro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# @tianditu/services
+
+![npm version](https://img.shields.io/npm/v/@tianditu/services)
+![npm downloads](https://img.shields.io/npm/dw/@tianditu/services)
+![npm license](https://img.shields.io/npm/l/@tianditu/services)
+
+> 天地图 REST 服务的类型化客户端，Node 与浏览器均可运行。
+> 覆盖地名搜索、驾车/公交规划、地理编码、逆地理编码、行政区划与静态地图：每个接口都有类型化的请求与响应，状态码语义与官方一致，与地图运行时解耦、可独立使用。
+
+## 特性
+
+- 🔌 **独立可用** — 纯请求封装，与地图运行时解耦；Node 与浏览器均可运行
+- 💪 **完整类型** — 每个接口都有类型化请求与响应（`SearchResult`、`DriveResult`、`TransitResult`、`GeoCodingResult`、`AdministrativeResult` 等）
+- 🧭 **接口齐全** — 地名搜索、驾车/公交规划、地理编码、逆地理编码、行政区划与静态地图
+- 🛟 **状态语义** — 结果状态码（`infocode`）原样暴露，含义与官方一致
+
+## 安装
+
+```bash
+# npm
+$ npm install @tianditu/services
+
+# yarn
+$ yarn add @tianditu/services
+
+# pnpm
+$ pnpm add @tianditu/services
+```
+
+## 快速开始
+
+```typescript
+import { defineTianditu } from "@tianditu/services";
+
+const tianditu = defineTianditu({
+  tk: "你的服务器端密钥",
+});
+
+const result = await tianditu.search({
+  keyWord: "北京站",
+  // 地名搜索V2.0：普通搜索（含地铁公交）
+  queryType: 1,
+  start: 0,
+  count: 10,
+});
+
+if (result.status.infocode === 1000) {
+  for (const poi of result.pois ?? []) {
+    console.log(poi.name, poi.address, poi.lonlat);
+  }
+}
+```
+
+## API
+
+| 方法                        | 参数                      | 说明          |
+| --------------------------- | ------------------------- | ------------- |
+| `search(postStr)`           | `SearchPostStr`           | 地名搜索 V2.0 |
+| `drive(postStr)`            | `DrivePostStr`            | 驾车路线规划  |
+| `transit(postStr)`          | `TransitPostStr`          | 公交路线规划  |
+| `geoCoding(ds)`             | `GeoCodingDs`             | 地理编码      |
+| `reverseGeoCoding(postStr)` | `ReverseGeoCodingPostStr` | 逆地理编码    |
+| `administrative(params)`    | `AdministrativeParams`    | 行政区划查询  |
+| `staticImage(params)`       | `StaticImageParams`       | 静态地图      |
+
+## 相关包
+
+- [@tianditu/core](https://www.npmjs.com/package/@tianditu/core) — 框架无关内核
+- [@tianditu/vue](https://www.npmjs.com/package/@tianditu/vue) — Vue 3 组件适配层
+- [@tianditu/web-components](https://www.npmjs.com/package/@tianditu/web-components) — Web Components 适配层
+
+## 许可
+
+- [MIT](LICENSE) © [Demo Macro](https://www.demomacro.com/)

package/dist/index.d.mts

@@ -0,0 +1,569 @@
+import { FetchOptions, FetchRequest } from "ofetch";
+//#region src/types/administrative.d.ts
+/**
+ * 行政区划 V2.0（官方文档 server/administrative2.html）。
+ * 端点 /v2/administrative，query 参数风格。
+ */
+interface AdministrativeParams {
+  /**
+   * 行政区划名称或编码；仅名称支持模糊查询。
+   * 仅一个字符时只返回 suggestion 字段，不返回 district 字段。
+   */
+  keyword: string;
+  /** 显示下级行政区级数：0 不返回、1 下一级、2 下两级、3 下三级 */
+  childLevel?: 0 | 1 | 2 | 3;
+  /** 是否需要轮廓数据 */
+  extensions?: boolean;
+}
+interface AdministrativeResult {
+  /** 返回描述 */
+  message: string;
+  /** 0 正常（官方文档同页亦标注 100/101 码表，以实际响应为准） */
+  status: number;
+  /** 行政区划信息 */
+  data: AdministrativeData;
+}
+interface AdministrativeData {
+  /** 建议搜索词（模糊匹配多条时返回；仅一条时为空） */
+  suggestion: string[];
+  /** 行政区划信息 */
+  district: AdministrativeDistrict[];
+}
+interface AdministrativeDistrict {
+  /** 行政区划名称 */
+  name: string;
+  /** 行政区划编码 */
+  gb: string;
+  /** 轮廓数据（extensions=true 时返回） */
+  boundary?: string;
+  /** 中心点坐标 */
+  center: AdministrativeCenter;
+  /** 行政区划级别：5 国家级、4 省级、3 市级、2 区县级 */
+  level: 2 | 3 | 4 | 5;
+  /** 下级行政区划信息 */
+  children: AdministrativeChild[];
+}
+interface AdministrativeChild {
+  /** 行政区划名称 */
+  name: string;
+  /** 行政区划编码 */
+  gb: string;
+  /** 中心点坐标 */
+  center: AdministrativeCenter;
+  /** 行政区划级别：5 国家级、4 省级、3 市级、2 区县级 */
+  level: 2 | 3 | 4 | 5;
+  /** 下级行政区划信息 */
+  children: AdministrativeChild[];
+}
+interface AdministrativeCenter {
+  /** 经度 */
+  lng: number;
+  /** 纬度 */
+  lat: number;
+}
+//#endregion
+//#region src/types/drive.d.ts
+/**
+ * 驾车规划（官方文档 server/drive.html）。
+ * 端点 /drive?type=search，postStr 为 JSON 串。
+ */
+interface DrivePostStr {
+  /** 起点经纬度 "lng,lat" */
+  orig: string;
+  /** 终点经纬度 "lng,lat" */
+  dest: string;
+  /** 途经点 "lng,lat;lng,lat" */
+  mid?: string;
+  /** 导航路线类型：0 最快、1 最短、2 避开高速、3 步行（默认 0） */
+  style?: "0" | "1" | "2" | "3";
+}
+/**
+ * 驾车规划响应。官方文档页的响应示例容器已失效（codeDemo 404），
+ * 无响应结构文档，故不臆造类型；待真实环境取样后补充。
+ */
+type DriveResult = Record<string, unknown>;
+//#endregion
+//#region src/types/geocoder.d.ts
+/**
+ * 地理编码（官方文档 server/geocodinginterface.html 正向、server/geocoding.html 逆向）。
+ * 端点均为 /geocoder：正向 ds 参数、逆向 postStr 参数（type=geocode）。
+ */
+/** 正向地理编码请求 */
+interface GeoCodingDs {
+  /** 请求关键字（结构化地址，仅限国内） */
+  keyWord: string;
+}
+interface GeoCodingResult {
+  /** 返回状态：0 正常、101 结果为空、404 出错 */
+  status: string;
+  /** 返回信息：OK 正常，其他异常 */
+  msg: string;
+  /** 地址信息 */
+  location: GeoCodingLocation;
+}
+interface GeoCodingLocation {
+  /** 坐标点显示经度 */
+  lon: number;
+  /** 坐标点显示纬度 */
+  lat: number;
+  /** 类别名称 */
+  level?: string;
+  /** 附近相似点（开启周边查询时返回） */
+  typeRound?: unknown[];
+}
+/** 逆地理编码请求 */
+interface ReverseGeoCodingPostStr {
+  /** 坐标的 x 值 */
+  lon: number;
+  /** 坐标的 y 值 */
+  lat: number;
+  /** 接口版本，默认 1 */
+  ver?: number;
+}
+interface ReverseGeoCodingResult {
+  /** 状态：0 正确、1 错误、404 出错 */
+  status: string;
+  /** 响应信息（OK 为有信息） */
+  msg: string;
+  /** 响应的具体信息（有结果时返回） */
+  result?: ReverseGeoCodingDetail;
+}
+interface ReverseGeoCodingDetail {
+  /** 此点的具体信息（分类） */
+  addressComponent: ReverseGeoCodingAddressComponent;
+  /** 详细地址 */
+  formatted_address: string;
+  /** 此点坐标 */
+  location: ReverseGeoCodingPoint;
+}
+interface ReverseGeoCodingAddressComponent {
+  /** 此点最近地点信息 */
+  address: string;
+  /** 距最近地点信息的距离 */
+  address_distince: number;
+  /** 此点在最近地点信息的方向 */
+  address_position: string;
+  /** 此点所在国家或城市或区县 */
+  city: string;
+  /** 距离此点最近的 poi 点 */
+  poi: string;
+  /** 距最近 poi 点的距离 */
+  poi_distince: number;
+  /** 此点在最近 poi 点的方向 */
+  poi_position: string;
+  /** 距离此点最近的路 */
+  road: string;
+  /** 此点距此路的距离 */
+  road_distince: number;
+}
+interface ReverseGeoCodingPoint {
+  /** 此点坐标 x 值 */
+  lon: string;
+  /** 此点坐标 y 值 */
+  lat: string;
+}
+//#endregion
+//#region src/types/search.d.ts
+/**
+ * 地名搜索 V2.0（官方文档 server/search2.html）。
+ * 端点 /v2/search?type=query，postStr 为 JSON 串。
+ */
+/**
+ * 搜索请求参数。必填项随 queryType 不同：
+ * - 1 普通：mapBound、level、start/count
+ * - 2 视野内 / 10 多边形：mapBound、level
+ * - 3 周边：mapBound、level、pointLonlat、queryRadius
+ * - 12 行政区划区域：specify
+ * - 13 数据分类：specify、dataTypes
+ * - 14 统计：specify
+ */
+interface SearchPostStr {
+  /** 搜索的关键字 */
+  keyWord: string;
+  /**
+   * 查询类型：1 普通（含地铁公交）、2 视野内、3 周边、10 多边形、
+   * 12 行政区划区域、13 数据分类、14 统计
+   */
+  queryType: 1 | 2 | 3 | 10 | 12 | 13 | 14;
+  /** 返回结果起始位（0-300），默认 0 */
+  start?: number;
+  /** 返回结果条数（1-300） */
+  count?: number;
+  /** 指定行政区国标码（9 位）或名称，如 "156110000" */
+  specify?: string;
+  /** 地图视野范围 "minx,miny,maxx,maxy"（-180,-90 至 180,90） */
+  mapBound?: string;
+  /** 目前查询的级别（1-18） */
+  level?: number;
+  /** 周边搜索中心点坐标 "lng,lat" */
+  pointLonlat?: string;
+  /** 周边搜索半径 */
+  queryRadius?: string;
+  /** 多边形搜索顶点串 "lng,lat;lng,lat;..." */
+  polygon?: string;
+  /** 数据分类（分类名称或编码，多个以英文逗号隔开） */
+  dataTypes?: string;
+  /** poi 结果信息类别：1 基本信息、2 详细信息 */
+  show?: 1 | 2;
+}
+interface SearchResult {
+  /** 结果类型：1 普通 POI、2 统计、3 行政区、4 建议词、5 线路 */
+  resultType: 1 | 2 | 3 | 4 | 5;
+  /** 返回总条数 */
+  count: number;
+  /** 搜索关键词 */
+  keyword: string;
+  /** POI 集合（resultType=1） */
+  pois?: SearchPoi[];
+  /** 统计集合（resultType=2） */
+  statistics?: SearchStatistics[];
+  /** 行政区集合（resultType=3） */
+  area?: SearchArea[];
+  /** 建议词（resultType=4；官方类型标注为 json，集合形式待真实环境验证） */
+  suggests?: SearchSuggest | SearchSuggest[];
+  /** 提示信息（需要提示时返回） */
+  prompt?: SearchPrompt;
+  /** 线路结果（resultType=5） */
+  lineData?: SearchLineData[];
+  /** 结果提示信息 */
+  status: SearchResultStatus;
+}
+interface SearchPoi {
+  /** poi 点名称 */
+  name: string;
+  /** 电话 */
+  phone?: string;
+  /** 地址 */
+  address?: string;
+  /** 坐标 "x,y" */
+  lonlat: string;
+  /** poi 类型：101 POI 数据、102 公交站点 */
+  poiType: 101 | 102;
+  /** 英文地址 */
+  eaddress?: string;
+  /** poi 点英文名称 */
+  ename?: string;
+  /** poi 热点 ID */
+  hotPointID: string;
+  /** 所属省名称 */
+  province?: string;
+  /** 省行政区编码 */
+  provinceCode?: string;
+  /** 所属城市名称 */
+  city?: string;
+  /** 市行政区编码 */
+  cityCode?: string;
+  /** 所属区县名称 */
+  county?: string;
+  /** 区县行政区编码 */
+  countyCode?: string;
+  /** 数据信息来源 */
+  source: string;
+  /** 分类编码 */
+  typeCode?: string;
+  /** 分类名称 */
+  typeName?: string;
+  /** 车站信息（poiType=102） */
+  stationData?: SearchStationData[];
+  /** 公交站 uuid */
+  stationUuid?: string;
+}
+interface SearchStationData {
+  /** 线路名称 */
+  lineName: string;
+  /** 线路的 id */
+  uuid: string;
+}
+interface SearchStatistics {
+  /** 本次统计 POI 总数量 */
+  count: number;
+  /** 行政区数量 */
+  adminCount: number;
+  /** 推荐行政区集合 */
+  priorityCitys: SearchPriorityCity[];
+  /** 各省包含信息集合 */
+  allAdmins: SearchAdmin[];
+}
+interface SearchPriorityCity {
+  /** 行政区名称 */
+  name: string;
+  /** 城市数量 */
+  count: number;
+  /** 行政区经纬度 "x,y" */
+  lonlat: string;
+  /** 英文行政名称 */
+  ename: string;
+  /** 城市国标码（9 位） */
+  adminCode: number;
+}
+interface SearchAdmin {
+  /** 行政名称 */
+  name: string;
+  /** 包含数量 */
+  count: number;
+  /** 行政区经纬度 "x,y" */
+  lonlat: string;
+  /** 省国标码 */
+  adminCode: string;
+  /** 英文行政名称 */
+  ename: string;
+  /** 有无下一级行政区：有则 false，无则 true */
+  isleaf: boolean;
+}
+interface SearchArea {
+  /** 名称 */
+  name: string;
+  /** 定位范围 "minx,miny,maxx,maxy" */
+  bound?: string;
+  /** 定位中心点坐标 "x,y" */
+  lonlat: string;
+  /** 行政区编码 */
+  adminCode: number;
+  /** 显示级别（1-18） */
+  level: number;
+}
+interface SearchSuggest {
+  /** 名称 */
+  name: string;
+  /** 地区地址（可能为空串） */
+  address: string;
+  /** 国标码 */
+  gbCode: string;
+}
+interface SearchPrompt {
+  /** 提示类型：1 是否在 where 搜 what、2 在 where 无结果、3 多个可跳转行政区、4 城市 */
+  type: 1 | 2 | 3 | 4;
+  /** 提示的行政区集合 */
+  admins: SearchPromptAdmin[];
+  /** 关键字 */
+  keyword: string;
+}
+interface SearchPromptAdmin {
+  /** 行政区名称 */
+  adminName: string;
+  /** 行政区划编码 */
+  adminCode: string;
+}
+interface SearchLineData {
+  /** 站数量 */
+  stationNum: string;
+  /** 类型，官方标注为 "103" */
+  poiType: string;
+  /** 线路名称 */
+  name: string;
+  /** 线路 id */
+  uuid: string;
+}
+interface SearchResultStatus {
+  /** 服务状态码（1000 正常，2001-2007 参数错误，3000 服务错误，3001 无数据） */
+  infocode: number;
+  /** 返回中文描述 */
+  cndesc: string;
+}
+//#endregion
+//#region src/types/staticImage.d.ts
+/**
+ * 静态地图（官方文档 staticapi/static.html）。
+ * 端点 /staticimage，返回 PNG 图片本体，可直接作为 <img src>。
+ */
+interface StaticImageParams {
+  /** 图片宽度（1-1024），默认 400 */
+  width?: number;
+  /** 图片高度（1-1024），默认 300 */
+  height?: number;
+  /** 地图中心点 "lng,lat" */
+  center?: string;
+  /** 地图级别（3-18），默认 10 */
+  zoom?: number;
+  /** 标注经纬度，多个以 "|" 隔开："lng,lat|lng,lat" */
+  markers?: string;
+  /** 标注样式，与 markers 一一对应，多个以 "|" 隔开 */
+  markerStyles?: string;
+  /** 折线，多条以 "|" 隔开，点间 ";"、坐标 ","："lng,lat;lng,lat|..." */
+  paths?: string;
+  /** 折线样式 "color,weight,opacity[,fillColor]"，多条以 "|" 隔开 */
+  pathStyles?: string;
+  /** 叠加图层类型组合，如 "vec_c,cva_c" */
+  layers?: string;
+  /** 传入经纬度时返回其相对图片左上角的屏幕坐标（优先于覆盖物参数） */
+  pixLocation?: string;
+}
+//#endregion
+//#region src/types/transit.d.ts
+/**
+ * 公交规划（官方文档 server/bus.html）。
+ * 端点 /transit?type=busline，postStr 为 JSON 串。
+ */
+/** 公交规划请求：线路规划 / uuid 详情查询 / 站点返程查询 三种形态 */
+type TransitPostStr = {
+  /** 出发点坐标 "经度,纬度" */
+  startposition: string;
+  /** 终点坐标 "经度,纬度" */
+  endposition: string;
+  /**
+   * 规划类型（按位组合）：第 0 位较快捷、第 1 位少换乘、
+   * 第 2 位少步行、第 3 位不坐地铁
+   */
+  linetype: string;
+} | {
+  /** 公交站或线路的 uuid */
+  uuid: string;
+} | {
+  /** 线路 ID */
+  lineUuid: string;
+  /** 站点 ID */
+  stationUuid: string;
+};
+interface TransitResult {
+  /**
+   * 返回数据状态：0 正常、1 找不到起点、2 找不到终点、3 规划失败、
+   * 4 起终点 200 米内建议步行、5 起终点 500 米内、6 参数错误
+   */
+  resultCode: number;
+  /** 返回线路中是否包含地铁：0 不包含、1 包含 */
+  hasSubway: 0 | 1;
+  /** 各请求类型的返回结果（请求几种返回几种） */
+  results: TransitTypeResult[];
+}
+interface TransitTypeResult {
+  /** 返回线路结果类型（同 linetype 位定义） */
+  lineType: number;
+  /** 该类型的规划线路（最多 5 条） */
+  lines: TransitLine[];
+}
+interface TransitLine {
+  /** 单条规划结果的线路名称，如 "3路—4路—5路" */
+  lineName: string;
+  /** 各段线路信息 */
+  segments: TransitSegment[];
+}
+interface TransitSegment {
+  /** 线路类型（1-4） */
+  segmentType: number;
+  /** 起站点 */
+  stationStart: TransitStation;
+  /** 终站点 */
+  stationEnd: TransitStation;
+  /** 线路内容 */
+  segmentLine: TransitSegmentLine;
+}
+interface TransitStation {
+  /** 站点名称 */
+  name: string;
+  /** 站的 id 信息 */
+  uuid: string;
+  /** 站点坐标 "x,y" */
+  lonlat: string;
+}
+interface TransitSegmentLine {
+  /** 此段线路名（不含括号内容） */
+  segmentName: string;
+  /** 此段线路的完整线路名 */
+  direction: string;
+  /** 此段线路坐标串 */
+  linePoint: string;
+  /** 此段距离（米）；步行且小于 20 米时不返回 */
+  segmentDistance: number;
+  /** 此段经过的站点数 */
+  segmentStationCount: number;
+  /** 此段耗时 */
+  segmentTime: number;
+}
+/** uuid 为线路时返回的线路详细信息 */
+interface TransitLineInfo {
+  /** 线路名称，如 "68路" */
+  lineName: string;
+  /** 线路类型：1 公交、2 地铁、3 磁悬浮 */
+  lineType: 1 | 2 | 3;
+  /** 线路长度（米） */
+  length: number;
+  /** 站点数据 */
+  station: TransitBusStation[];
+  /** 线路详细坐标串，点之间空格隔开 */
+  linePoint: string;
+  /** 始发车时间 "hh:mm"（24 小时制） */
+  startTime: string;
+  /** 末班车时间 "hh:mm"（24 小时制） */
+  endTime: string;
+  /** 全程运营总时间（分钟） */
+  totalTime: number;
+  /** 站点总数量 */
+  stationCount: number;
+  /** 发车间隔（秒） */
+  interval: number;
+  /** 计费模式：0 单一、1 按距离、2 按站 */
+  ticketcal: 0 | 1 | 2;
+  /** 全程票价（分） */
+  totalPrice: number;
+  /** 起步票价（分） */
+  startPrice: number;
+  /** 递增距离票价（按千米） */
+  increasedPrice: number;
+  /** 车站递增票价（按站） */
+  increasedStep: number;
+  /** 是否支持月票：0 不支持、1 支持 */
+  ismonTicket: 0 | 1;
+  /** 是否双向行驶：0 单向、1 双向 */
+  isBidirectional: 0 | 1;
+  /** 是否人工售票：0 有人、1 无人 */
+  isManual: 0 | 1;
+  /** 状态：0 使用中、1 非使用中 */
+  status: 0 | 1;
+  /** 所属公交公司 */
+  company: string;
+}
+/** uuid 为公交站时返回的站点信息 */
+interface TransitBusStation {
+  /** 站点名称 */
+  name: string;
+  /** 站的 id 信息 */
+  uuid: string;
+  /** 途经线路信息 */
+  linedata: TransitBusLineData[];
+  /** 站点坐标 "x,y" */
+  lonlat: string;
+}
+interface TransitBusLineData {
+  /** 线路名称 */
+  name: string;
+  /** 线路的 id */
+  uuid: string;
+}
+//#endregion
+//#region src/web.d.ts
+declare class TianDiTu {
+  tk: string;
+  baseURL: string;
+  private client;
+  constructor(tk: string, baseURL?: string);
+  apiFetch<T>(request: FetchRequest, options?: FetchOptions<"json">): Promise<T>;
+  /** 地名搜索 V2.0（官方 server/search2.html） */
+  search(postStr: SearchPostStr): Promise<SearchResult>;
+  /** 驾车规划（官方 server/drive.html） */
+  drive(postStr: DrivePostStr): Promise<DriveResult>;
+  /** 公交规划 / 公交 uuid 详情查询 / 站点返程查询（官方 server/bus.html） */
+  transit(postStr: TransitPostStr): Promise<TransitResult | TransitLineInfo | TransitBusStation>;
+  /** 正向地理编码：地址转坐标（官方 server/geocodinginterface.html） */
+  geoCoding(ds: GeoCodingDs): Promise<GeoCodingResult>;
+  /** 逆地理编码：坐标转地址（官方 server/geocoding.html） */
+  reverseGeoCoding(postStr: ReverseGeoCodingPostStr): Promise<ReverseGeoCodingResult>;
+  /** 行政区划 V2.0（官方 server/administrative2.html） */
+  administrative(params: AdministrativeParams): Promise<AdministrativeResult>;
+  /**
+   * 静态地图 URL（官方 staticapi/static.html）：服务返回 PNG 图片本体，
+   * 此处只构造 URL，直接用于 <img src>，不做请求。
+   */
+  staticImage(params?: StaticImageParams): string;
+}
+//#endregion
+//#region src/index.d.ts
+/**
+ * SDK 脚本加载已移交 @tianditu/core 的 loadTdt，本包只负责
+ * 天地图 REST 服务的请求封装。
+ */
+declare function defineTianditu({ tk, baseURL }: {
+  tk: string;
+  baseURL?: string;
+}): TianDiTu;
+//#endregion
+export { type AdministrativeCenter, type AdministrativeChild, type AdministrativeData, type AdministrativeDistrict, type AdministrativeParams, type AdministrativeResult, type DrivePostStr, type DriveResult, type GeoCodingDs, type GeoCodingLocation, type GeoCodingResult, type ReverseGeoCodingAddressComponent, type ReverseGeoCodingDetail, type ReverseGeoCodingPoint, type ReverseGeoCodingPostStr, type ReverseGeoCodingResult, type SearchAdmin, type SearchArea, type SearchLineData, type SearchPoi, type SearchPostStr, type SearchPriorityCity, type SearchPrompt, type SearchPromptAdmin, type SearchResult, type SearchResultStatus, type SearchStationData, type SearchStatistics, type SearchSuggest, type StaticImageParams, TianDiTu, type TransitBusLineData, type TransitBusStation, type TransitLine, type TransitLineInfo, type TransitPostStr, type TransitResult, type TransitSegment, type TransitSegmentLine, type TransitStation, type TransitTypeResult, defineTianditu };

package/dist/index.mjs

@@ -0,0 +1,84 @@
+import { ofetch } from "ofetch";
+//#region src/web.ts
+var TianDiTu = class {
+	constructor(tk, baseURL) {
+		this.baseURL = "https://api.tianditu.gov.cn";
+		this.tk = tk;
+		this.baseURL = baseURL || this.baseURL;
+		this.client = ofetch.create({ baseURL: this.baseURL });
+	}
+	apiFetch(request, options) {
+		return this.client(request, options);
+	}
+	/** 地名搜索 V2.0（官方 server/search2.html） */
+	async search(postStr) {
+		return await this.apiFetch("/v2/search", { params: {
+			tk: this.tk,
+			type: "query",
+			postStr: JSON.stringify(postStr)
+		} });
+	}
+	/** 驾车规划（官方 server/drive.html） */
+	async drive(postStr) {
+		return await this.apiFetch("/drive", { params: {
+			tk: this.tk,
+			type: "search",
+			postStr: JSON.stringify(postStr)
+		} });
+	}
+	/** 公交规划 / 公交 uuid 详情查询 / 站点返程查询（官方 server/bus.html） */
+	async transit(postStr) {
+		return await this.apiFetch("/transit", { params: {
+			tk: this.tk,
+			type: "busline",
+			postStr: JSON.stringify(postStr)
+		} });
+	}
+	/** 正向地理编码：地址转坐标（官方 server/geocodinginterface.html） */
+	async geoCoding(ds) {
+		return await this.apiFetch("/geocoder", { params: {
+			tk: this.tk,
+			ds: JSON.stringify(ds)
+		} });
+	}
+	/** 逆地理编码：坐标转地址（官方 server/geocoding.html） */
+	async reverseGeoCoding(postStr) {
+		return await this.apiFetch("/geocoder", { params: {
+			tk: this.tk,
+			type: "geocode",
+			postStr: JSON.stringify({
+				ver: 1,
+				...postStr
+			})
+		} });
+	}
+	/** 行政区划 V2.0（官方 server/administrative2.html） */
+	async administrative(params) {
+		return await this.apiFetch("/v2/administrative", { params: {
+			tk: this.tk,
+			...params
+		} });
+	}
+	/**
+	* 静态地图 URL（官方 staticapi/static.html）：服务返回 PNG 图片本体，
+	* 此处只构造 URL，直接用于 <img src>，不做请求。
+	*/
+	staticImage(params = {}) {
+		const search = new URLSearchParams({
+			tk: this.tk,
+			...Object.fromEntries(Object.entries(params).filter(([, value]) => value !== void 0))
+		});
+		return `${this.baseURL}/staticimage?${search}`;
+	}
+};
+//#endregion
+//#region src/index.ts
+/**
+* SDK 脚本加载已移交 @tianditu/core 的 loadTdt，本包只负责
+* 天地图 REST 服务的请求封装。
+*/
+function defineTianditu({ tk, baseURL }) {
+	return new TianDiTu(tk, baseURL);
+}
+//#endregion
+export { TianDiTu, defineTianditu };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@tianditu/services",
+  "version": "0.1.0",
+  "description": "Typed REST client for tianditu services — place search, driving and transit planning, geocoding, administrative divisions, and static images, standalone from the map runtime",
+  "keywords": [
+    "administrative-divisions",
+    "api-client",
+    "geocoding",
+    "gis",
+    "lbs",
+    "map",
+    "rest",
+    "reverse-geocoding",
+    "route-planning",
+    "search",
+    "static-image",
+    "tianditu",
+    "transit",
+    "typescript"
+  ],
+  "homepage": "https://github.com/DemoMacro/tianditu#readme",
+  "bugs": {
+    "url": "https://github.com/DemoMacro/tianditu/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Demo Macro",
+    "email": "abc@imst.xyz",
+    "url": "https://www.demomacro.com/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DemoMacro/tianditu.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "dependencies": {
+    "ofetch": "1.3.4"
+  },
+  "scripts": {
+    "build": "vp pack"
+  }
+}