measurement_along
Calculate coordinates at a specific distance along a GeoJSON line. Input a LineString and distance to find the corresponding point location along the path.
Instructions
在线上计算指定距离处的点位置。
此功能沿着给定线段从起点开始移动指定距离，找到对应的坐标点位置。
Args: line: GeoJSON LineString 特征或几何图形 - 类型: str (JSON 字符串格式的 GeoJSON) - 格式: 必须符合 GeoJSON LineString 规范 - 坐标系: WGS84 (经度在前，纬度在后) - 示例: '{"type": "LineString", "coordinates": [[-83, 30], [-84, 36], [-78, 41]]}'
distance: 沿线的距离
- 类型: float
- 描述: 从起点开始沿线的距离值
- 范围: 0 到线的总长度（超出范围会自动截断到端点）
- 示例: 200.0
options: 可选参数配置
- 类型: str (JSON 字符串) 或 None
- 可选字段:
- units: 距离单位 (默认: 'kilometers')
- 有效值: 'miles', 'nauticalmiles', 'kilometers', 'meters', 'yards', 'feet', 'inches'
- 其他 Turf.js 支持的选项参数
- 示例: '{"units": "miles"}'Returns: str: JSON 字符串格式的 GeoJSON Point 特征 - 类型: GeoJSON Feature with Point geometry - 格式: {"type": "Feature", "geometry": {"type": "Point", "coordinates": [lng, lat]}} - 示例: '{"type": "Feature", "geometry": {"type": "Point", "coordinates": [-82.5, 33.2]}}'
Raises: Exception: 当 JavaScript 执行失败、超时或输入数据格式错误时抛出异常
Example: >>> import asyncio >>> line = '{"type": "LineString", "coordinates": [[-83, 30], [-84, 36], [-78, 41]]}' >>> options = '{"units": "miles"}' >>> result = asyncio.run(along(line, 200, options)) >>> print(result) '{"type": "Feature", "geometry": {"type": "Point", "coordinates": [-82.5, 33.2]}}'
Notes: - 如果距离超过线长度，会自动返回线终点 - 如果距离为负值，会自动返回线起点 - 输入参数 line 和 options 必须是有效的 JSON 字符串 - 坐标顺序为 [经度, 纬度] (WGS84 坐标系) - 依赖于 Turf.js 库和 Node.js 环境
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| line | Yes | ||
| distance | Yes | ||
| options | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |