跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
搜索与研究

mapbox-geospatial-operations

Expert guidance on choosing the right geospatial tool based on problem type, accuracy requirements, and performance needs

mapbox · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add mapbox/mapbox-agent-skills --skill mapbox-geospatial-operations

技能说明


name: mapbox-geospatial-operations description: Expert guidance on choosing the right geospatial tool based on problem type, accuracy requirements, and performance needs

Mapbox Geospatial Operations Skill

Expert guidance for AI assistants on choosing the right geospatial tools from the Mapbox MCP Server. Focuses on selecting tools based on what the problem requires - geometric calculations vs routing, straight-line vs road network, and accuracy needs.

Core Principle: Problem Type Determines Tool Choice

The Mapbox MCP Server provides two categories of geospatial tools:

  1. Offline Geometric Tools - Use Turf.js for pure geometric/spatial calculations
  2. Routing & Navigation APIs - Use Mapbox APIs when you need real-world routing, traffic, or travel times

The key question: What does the problem actually require?

Decision Framework

Problem CharacteristicTool CategoryWhy
Straight-line distance (as the crow flies)Offline geometricAccurate for geometric distance
Road/path distance (as the crow drives)Routing APIOnly routing APIs know road networks
Travel timeRouting APIRequires routing with speed/traffic data
Point containment (is X inside Y?)Offline geometricPure geometric operation
Geographic shapes (buffers, centroids, areas)Offline geometricMathematical/geometric operations
Traffic-aware routingRouting APIRequires real-time traffic data
Route optimization (best order to visit)Routing APIComplex routing algorithm
High-frequency checks (e.g., real-time geofencing)Offline geometricInstant response, no latency

Decision Matrices by Use Case

Distance Calculations

User asks: "How far is X from Y?"

What They Actually MeanTool ChoiceWhy
Straight-line distance (as the crow flies)distance_toolAccurate for geometric distance, instant
Driving distance (as the crow drives)directions_toolOnly routing knows actual road distance
Walking/cycling distance (as the crow walks/bikes)directions_toolNeed specific path network
Travel timedirections_tool or matrix_toolRequires routing with speed data
Distance with current trafficdirections_tool (driving-traffic)Need real-time traffic consideration

Example: "What's the distance between these 5 warehouses?"

  • As the crow flies → distance_tool (10 calculations, instant)
  • As the crow drives → matrix_tool (5×5 matrix, one API call, returns actual route distances)

Key insight: Use the tool that matches what "distance" means in context. Always clarify: crow flies or crow drives?

Proximity and Containment

User asks: "Which points are near/inside this area?"

Query TypeTool ChoiceWhy
"Within X meters radius"distance_tool + filterSimple geometric radius
"Within X minutes drive"isochrone_tool → point_in_polygon_toolNeed routing for travel-time zone, then geometric containment
"Inside this polygon"point_in_polygon_toolPure geometric containment test
"Reachable by car in 30 min"isochrone_toolRequires routing + traffic
"Nearest to this point"distance_tool (geometric) or matrix_tool (routed)Depends on definition of "nearest"

Example: "Are these 200 addresses in our 30-minute delivery zone?"

  1. Create zone → isochrone_tool (routing API - need travel time)
  2. Check addresses → point_in_polygon_tool (geometric - 200 instant checks)

Key insight: Routing for creating travel-time zones, geometric for containment checks

Routing and Navigation

User asks: "What's the best route?"

ScenarioTool ChoiceWhy
A to B directionsdirections_toolTurn-by-turn routing
Optimal order for multiple stopsoptimization_toolSolves traveling salesman problem
Clean GPS tracemap_matching_toolSnaps to road network
Just need bearing/compass directionbearing_toolSimple geometric calculation
Route with trafficdirections_tool (driving-traffic)Real-time traffic awareness
Fixed-order waypointsdirections_tool with waypointsRouting through specific points

Example: "Navigate from hotel to airport"

阅读完整来源 ↗