[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-mapbox-mapbox-geospatial-operations":3,"mdc-6pzcsg-key":30,"related-org-mapbox-mapbox-geospatial-operations":3882,"related-repo-mapbox-mapbox-geospatial-operations":4052},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":20,"repoUrl":21,"updatedAt":22,"license":23,"forks":24,"topics":25,"repo":26,"sourceUrl":28,"mdContent":29},"mapbox-geospatial-operations","select geospatial tools for Mapbox operations","Expert guidance on choosing the right geospatial tool based on problem type, accuracy requirements, and performance needs",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"mapbox","Mapbox","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fmapbox.png",[12,16,17],{"name":13,"slug":14,"type":15},"Performance","performance","tag",{"name":9,"slug":8,"type":15},{"name":18,"slug":19,"type":15},"Strategy","strategy",69,"https:\u002F\u002Fgithub.com\u002Fmapbox\u002Fmapbox-agent-skills","2026-07-30T05:30:52.766227",null,10,[],{"repoUrl":21,"stars":20,"forks":24,"topics":27,"description":23},[],"https:\u002F\u002Fgithub.com\u002Fmapbox\u002Fmapbox-agent-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fmapbox-geospatial-operations","---\nname: mapbox-geospatial-operations\ndescription: Expert guidance on choosing the right geospatial tool based on problem type, accuracy requirements, and performance needs\n---\n\n# Mapbox Geospatial Operations Skill\n\nExpert 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.\n\n## Core Principle: Problem Type Determines Tool Choice\n\nThe Mapbox MCP Server provides two categories of geospatial tools:\n\n1. **Offline Geometric Tools** - Use Turf.js for pure geometric\u002Fspatial calculations\n2. **Routing & Navigation APIs** - Use Mapbox APIs when you need real-world routing, traffic, or travel times\n\n**The key question: What does the problem actually require?**\n\n### Decision Framework\n\n| Problem Characteristic                                 | Tool Category     | Why                                      |\n| ------------------------------------------------------ | ----------------- | ---------------------------------------- |\n| **Straight-line distance** (as the crow flies)         | Offline geometric | Accurate for geometric distance          |\n| **Road\u002Fpath distance** (as the crow drives)            | Routing API       | Only routing APIs know road networks     |\n| **Travel time**                                        | Routing API       | Requires routing with speed\u002Ftraffic data |\n| **Point containment** (is X inside Y?)                 | Offline geometric | Pure geometric operation                 |\n| **Geographic shapes** (buffers, centroids, areas)      | Offline geometric | Mathematical\u002Fgeometric operations        |\n| **Traffic-aware routing**                              | Routing API       | Requires real-time traffic data          |\n| **Route optimization** (best order to visit)           | Routing API       | Complex routing algorithm                |\n| **High-frequency checks** (e.g., real-time geofencing) | Offline geometric | Instant response, no latency             |\n\n## Decision Matrices by Use Case\n\n### Distance Calculations\n\n**User asks: \"How far is X from Y?\"**\n\n| What They Actually Mean                            | Tool Choice                         | Why                                      |\n| -------------------------------------------------- | ----------------------------------- | ---------------------------------------- |\n| Straight-line distance (as the crow flies)         | `distance_tool`                     | Accurate for geometric distance, instant |\n| Driving distance (as the crow drives)              | `directions_tool`                   | Only routing knows actual road distance  |\n| Walking\u002Fcycling distance (as the crow walks\u002Fbikes) | `directions_tool`                   | Need specific path network               |\n| Travel time                                        | `directions_tool` or `matrix_tool`  | Requires routing with speed data         |\n| Distance with current traffic                      | `directions_tool` (driving-traffic) | Need real-time traffic consideration     |\n\n**Example: \"What's the distance between these 5 warehouses?\"**\n\n- As the crow flies → `distance_tool` (10 calculations, instant)\n- As the crow drives → `matrix_tool` (5×5 matrix, one API call, returns actual route distances)\n\n**Key insight:** Use the tool that matches what \"distance\" means in context. Always clarify: crow flies or crow drives?\n\n### Proximity and Containment\n\n**User asks: \"Which points are near\u002Finside this area?\"**\n\n| Query Type                   | Tool Choice                                           | Why                                                           |\n| ---------------------------- | ----------------------------------------------------- | ------------------------------------------------------------- |\n| \"Within X meters radius\"     | `distance_tool` + filter                              | Simple geometric radius                                       |\n| \"Within X minutes drive\"     | `isochrone_tool` → `point_in_polygon_tool`            | Need routing for travel-time zone, then geometric containment |\n| \"Inside this polygon\"        | `point_in_polygon_tool`                               | Pure geometric containment test                               |\n| \"Reachable by car in 30 min\" | `isochrone_tool`                                      | Requires routing + traffic                                    |\n| \"Nearest to this point\"      | `distance_tool` (geometric) or `matrix_tool` (routed) | Depends on definition of \"nearest\"                            |\n\n**Example: \"Are these 200 addresses in our 30-minute delivery zone?\"**\n\n1. Create zone → `isochrone_tool` (routing API - need travel time)\n2. Check addresses → `point_in_polygon_tool` (geometric - 200 instant checks)\n\n**Key insight:** Routing for creating travel-time zones, geometric for containment checks\n\n### Routing and Navigation\n\n**User asks: \"What's the best route?\"**\n\n| Scenario                            | Tool Choice                         | Why                               |\n| ----------------------------------- | ----------------------------------- | --------------------------------- |\n| A to B directions                   | `directions_tool`                   | Turn-by-turn routing              |\n| Optimal order for multiple stops    | `optimization_tool`                 | Solves traveling salesman problem |\n| Clean GPS trace                     | `map_matching_tool`                 | Snaps to road network             |\n| Just need bearing\u002Fcompass direction | `bearing_tool`                      | Simple geometric calculation      |\n| Route with traffic                  | `directions_tool` (driving-traffic) | Real-time traffic awareness       |\n| Fixed-order waypoints               | `directions_tool` with waypoints    | Routing through specific points   |\n\n**Example: \"Navigate from hotel to airport\"**\n\n- Need turn-by-turn → `directions_tool`\n- Just need to know \"it's northeast\" → `bearing_tool`\n\n**Key insight:** Routing tools for actual navigation, geometric tools for directional info\n\n### Area and Shape Operations\n\n**User asks: \"Create a zone around this location\"**\n\n| Requirement               | Tool Choice      | Why                      |\n| ------------------------- | ---------------- | ------------------------ |\n| Simple circular buffer    | `buffer_tool`    | Geometric circle\u002Fradius  |\n| Travel-time zone          | `isochrone_tool` | Based on routing network |\n| Calculate area size       | `area_tool`      | Geometric calculation    |\n| Simplify complex boundary | `simplify_tool`  | Geometric simplification |\n| Find center of shape      | `centroid_tool`  | Geometric centroid       |\n\n**Example: \"Show 5km coverage around each store\"**\n\n- 5km radius → `buffer_tool` (geometric circles)\n- \"What customers can reach in 15 min?\" → `isochrone_tool` (routing-based)\n\n**Key insight:** Geometric tools for distance-based zones, routing tools for time-based zones\n\n## Performance and Scale Considerations\n\n### When Volume Affects Tool Choice\n\n**Small operations (\u003C 100 calculations):**\n\n- Geometric tools: Instant, iterate freely\n- Routing APIs: Fast enough for most uses\n\n**Medium operations (100-1,000 calculations):**\n\n- Geometric tools: Still fast, no concerns\n- Routing APIs: Consider batch operations (matrix_tool)\n\n**Large operations (> 1,000 calculations):**\n\n- Geometric tools: May need optimization but still fast\n- Routing APIs: Definitely use batch tools (matrix_tool handles up to 25×25)\n\n**Key insight:** Volume rarely affects geometric tool choice, but routing APIs have batch tools for efficiency\n\n### Real-Time vs Batch\n\n| Use Case                            | Approach             | Tool Choice                              |\n| ----------------------------------- | -------------------- | ---------------------------------------- |\n| Real-time geofencing (every second) | Geometric checks     | `point_in_polygon_tool` (instant)        |\n| Route planning (one-time)           | Full routing         | `directions_tool` or `optimization_tool` |\n| Periodic proximity checks           | Geometric distance   | `distance_tool`                          |\n| Live traffic routing                | Routing with traffic | `directions_tool` (driving-traffic)      |\n\n**Architecture note for high-frequency geofencing:** If the application calls containment checks at very high rates (e.g., 50 vehicles every 2 seconds = 25 checks\u002Fsecond), calling MCP tools over the network adds agent-reasoning overhead that makes it impractical. In those cases, recommend using Turf.js directly in-process (`turf.booleanPointInPolygon`) for the hot path, and reserve MCP tools for peripheral tasks like zone definition (`isochrone_tool`), rerouting (`directions_tool`), or visualization (`static_map_image_tool`).\n\n## Common Scenarios and Optimal Approaches\n\n### Scenario 1: Store Locator\n\n**User: \"Find the closest store and show 5km coverage\"**\n\n**Optimal approach:**\n\n1. Search stores → `category_search_tool` (returns distances automatically)\n2. Create coverage zone → `buffer_tool` (5km geometric circle)\n3. Visualize → `static_map_image_tool`\n\n**Why:** Search already gives distances; geometric buffer for simple radius\n\n### Scenario 2: Delivery Route Optimization\n\n**User: \"Optimize delivery to 8 addresses \u002F stops\"**\n\n**Optimal approach:**\n\n1. **Geocode addresses (if needed)** → Use `search_and_geocode_tool` to convert any street addresses to coordinates. Even when coordinates are already provided, mention this as an optional pre-step — real-world delivery lists often contain a mix of addresses and coordinates.\n2. **Optimize route** → `optimization_tool` (TSP solver — reorders stops to minimize total drive time)\n\n**Why `optimization_tool` and NOT these alternatives:**\n\n- **`directions_tool`** only routes A → B (or through fixed-order waypoints). It does NOT reorder stops — if you pass 8 stops, it routes them in the order given, which is almost never optimal.\n- **`matrix_tool`** gives travel times between all pairs of stops (8×8 = 64 values), but it does NOT compute the optimal ordering. You'd need to solve TSP yourself on top of the matrix — `optimization_tool` does this for you in one call.\n\nAlways mention `search_and_geocode_tool` as a useful companion for geocoding delivery addresses before optimization.\n\n### Scenario 3: Service Area Validation\n\n**User: \"Which of these 200 addresses can we deliver to in 30 minutes?\"**\n\n**Optimal approach:**\n\n1. Create delivery zone → `isochrone_tool` (30-minute driving)\n2. Check each address → `point_in_polygon_tool` (200 geometric checks)\n\n**Why:** Routing for accurate travel-time zone, geometric for fast containment checks\n\n### Scenario 4: GPS Trace Analysis\n\n**User: \"How long was this bike ride?\"**\n\n**Optimal approach:**\n\n1. Clean GPS trace → `map_matching_tool` (snap to bike paths)\n2. Get distance → Use API response or calculate with `distance_tool`\n\n**Why:** Need road\u002Fpath matching; distance calculation either way works\n\n### Scenario 5: Coverage Analysis\n\n**User: \"What's our total service area?\"**\n\n**Optimal approach:**\n\n1. Create buffers around each location → `buffer_tool`\n2. Calculate total area → `area_tool`\n3. Or, if time-based → `isochrone_tool` for each location\n\n**Why:** Geometric for distance-based coverage, routing for time-based\n\n## Anti-Patterns: Using the Wrong Tool Type\n\n### ❌ Don't: Use geometric tools for routing questions\n\n```javascript\n\u002F\u002F WRONG: User asks \"how long to drive there?\"\ndistance_tool({ from: A, to: B });\n\u002F\u002F Returns 10km as the crow flies, but actual drive is 15km\n\n\u002F\u002F CORRECT: Need routing for driving distance\ndirections_tool({\n  coordinates: [\n    { longitude: A[0], latitude: A[1] },\n    { longitude: B[0], latitude: B[1] }\n  ],\n  routing_profile: 'mapbox\u002Fdriving'\n});\n\u002F\u002F Returns actual road distance and drive time as the crow drives\n```\n\n**Why wrong:** As the crow flies ≠ as the crow drives\n\n### ❌ Don't: Use routing APIs for geometric operations\n\n```javascript\n\u002F\u002F WRONG: Check if point is in polygon\n\u002F\u002F (Can't do this with routing APIs)\n\n\u002F\u002F CORRECT: Pure geometric operation\npoint_in_polygon_tool({ point: location, polygon: boundary });\n```\n\n**Why wrong:** Routing APIs don't do geometric containment\n\n### ❌ Don't: Confuse \"near\" with \"reachable\"\n\n```javascript\n\u002F\u002F User asks: \"What's reachable in 20 minutes?\"\n\n\u002F\u002F WRONG: 20-minute distance at average speed\ndistance_tool + calculate 20min * avg_speed\n\n\u002F\u002F CORRECT: Actual routing with road network\nisochrone_tool({\n  coordinates: {longitude: startLng, latitude: startLat},\n  contours_minutes: [20],\n  profile: \"mapbox\u002Fdriving\"\n})\n```\n\n**Why wrong:** Roads aren't straight lines; traffic varies\n\n### ❌ Don't: Use routing when bearing is sufficient\n\n```javascript\n\u002F\u002F User asks: \"Which direction is the airport?\"\n\n\u002F\u002F OVERCOMPLICATED: Full routing\ndirections_tool({\n  coordinates: [\n    { longitude: hotel[0], latitude: hotel[1] },\n    { longitude: airport[0], latitude: airport[1] }\n  ]\n});\n\n\u002F\u002F BETTER: Just need bearing\nbearing_tool({ from: hotel, to: airport });\n\u002F\u002F Returns: \"Northeast (45°)\"\n```\n\n**Why better:** Simpler, instant, answers the actual question\n\n## Hybrid Approaches: Combining Tool Types\n\nSome problems benefit from using both geometric and routing tools:\n\n### Pattern 1: Routing + Geometric Filter\n\n```\n1. directions_tool → Get route geometry\n2. buffer_tool → Create corridor around route\n3. category_search_tool → Find POIs in corridor\n4. point_in_polygon_tool → Filter to those actually along route\n```\n\n**Use case:** \"Find gas stations along my route\"\n\n### Pattern 2: Routing + Distance Calculation\n\n```\n1. category_search_tool → Find 10 nearby locations\n2. distance_tool → Calculate straight-line distances (geometric)\n3. For top 3, use directions_tool → Get actual driving time\n```\n\n**Use case:** Quickly narrow down, then get precise routing for finalists\n\n### Pattern 3: Isochrone + Containment\n\n```\n1. isochrone_tool → Create travel-time zone (routing)\n2. point_in_polygon_tool → Check hundreds of addresses (geometric)\n```\n\n**Use case:** \"Which customers are in our delivery zone?\"\n\n## Decision Algorithm\n\nWhen user asks a geospatial question:\n\n```\n1. Does it require routing, roads, or travel times?\n   YES → Use routing API (directions, matrix, isochrone, optimization)\n   NO → Continue\n\n2. Does it require traffic awareness?\n   YES → Use directions_tool or isochrone_tool with traffic profile\n   NO → Continue\n\n3. Is it a geometric\u002Fspatial operation?\n   - Distance between points (straight-line) → distance_tool\n   - Point containment → point_in_polygon_tool\n   - Area calculation → area_tool\n   - Buffer\u002Fzone → buffer_tool\n   - Direction\u002Fbearing → bearing_tool\n   - Geometric center → centroid_tool\n   - Bounding box → bounding_box_tool\n   - Simplification → simplify_tool\n\n4. Is it a search\u002Fdiscovery operation?\n   YES → Use search tools (search_and_geocode, category_search)\n```\n\n## Key Decision Questions\n\nBefore choosing a tool, ask:\n\n1. **Does \"distance\" mean as the crow flies or as the crow drives?**\n   - As the crow flies (straight-line) → geometric tools\n   - As the crow drives (road distance) → routing APIs\n\n2. **Does the user need travel time?**\n   - Yes → routing APIs (only they know speeds\u002Ftraffic)\n   - No → geometric tools may suffice\n\n3. **Is this about roads\u002Fpaths or pure spatial relationships?**\n   - Roads\u002Fpaths → routing APIs\n   - Spatial relationships → geometric tools\n\n4. **Does this need to happen in real-time with low latency?**\n   - Yes + geometric problem → offline tools (instant)\n   - Yes + routing problem → use routing APIs (still fast)\n\n5. **Is accuracy critical, or is approximation OK?**\n   - Critical + routing → routing APIs\n   - Approximation OK → geometric tools may work\n\n## Terminology Guide\n\nUnderstanding what users mean:\n\n| User Says             | Usually Means                                      | Tool Type   |\n| --------------------- | -------------------------------------------------- | ----------- |\n| \"Distance\"            | Context-dependent! Ask: crow flies or crow drives? | Varies      |\n| \"How far\"             | Often as the crow drives (road distance)           | Routing API |\n| \"Nearby\"              | Usually as the crow flies (straight-line radius)   | Geometric   |\n| \"Close\"               | Could be either - clarify!                         | Ask         |\n| \"Reachable\"           | Travel-time based (crow drives with traffic)       | Routing API |\n| \"Inside\u002Fcontains\"     | Geometric containment                              | Geometric   |\n| \"Navigate\u002Fdirections\" | Turn-by-turn routing                               | Routing API |\n| \"Bearing\u002Fdirection\"   | Compass direction (crow flies)                     | Geometric   |\n\n## Quick Reference\n\n### Geometric Operations (Offline Tools)\n\n- `distance_tool` - Straight-line distance between two points\n- `bearing_tool` - Compass direction from A to B\n- `midpoint_tool` - Midpoint between two points\n- `point_in_polygon_tool` - Is point inside polygon?\n- `area_tool` - Calculate polygon area\n- `buffer_tool` - Create circular buffer\u002Fzone\n- `centroid_tool` - Geometric center of polygon\n- `bbox_tool` - Min\u002Fmax coordinates of geometry\n- `simplify_tool` - Reduce geometry complexity\n\n### Routing & Navigation (APIs)\n\n- `directions_tool` - Turn-by-turn routing\n- `matrix_tool` - Many-to-many travel times\n- `optimization_tool` - Route optimization (TSP)\n- `isochrone_tool` - Travel-time zones\n- `map_matching_tool` - Snap GPS to roads\n\n### When to Use Each Category\n\n**Use Geometric Tools When:**\n\n- Problem is spatial\u002Fmathematical (containment, area, bearing)\n- Straight-line distance is appropriate\n- Need instant results for real-time checks\n- Pure geometry (no roads\u002Ftraffic involved)\n\n**Use Routing APIs When:**\n\n- Need actual driving\u002Fwalking\u002Fcycling distances\n- Need travel times\n- Need to consider road networks\n- Need traffic awareness\n- Need route optimization\n- Need turn-by-turn directions\n\n## REST API honesty (Directions \u002F Isochrone)\n\nWhen generating browser demos against Mapbox REST APIs (not only MCP tools):\n\n### Directions — use the route object metrics\n\n```javascript\nconst route = data.routes[0];\n\u002F\u002F GOOD — meters \u002F seconds from the API\nstats.textContent =\n  `Distance ${(route.distance \u002F 1000).toFixed(2)} km · ` + `Duration ${Math.round(route.duration \u002F 60)} min`;\n\n\u002F\u002F BAD — cosmetic labels or hardcoded ETAs that look like a working demo\n\u002F\u002F \"Len 0.00 km · Time 2 min\" \u002F Math.round(120\u002F60)\n```\n\n### Isochrone — request multiple contours when the prompt asks for bands\n\n```javascript\n\u002F\u002F GOOD — three travel-time bands\n`contours_minutes=15,30,60`;\n\n\u002F\u002F BAD — a single contour when the UX needs 15 \u002F 30 \u002F 60\n`contours_minutes=30`;\n```\n\n## Integration with Other Skills\n\n**Works with:**\n\n- **mapbox-search-patterns**: Search for locations, then use geospatial operations\n- **mapbox-web-performance-patterns**: Optimize rendering of geometric calculations\n- **mapbox-token-security**: Ensure requests use properly scoped tokens\n\n## Resources\n\n- [Mapbox MCP Server](https:\u002F\u002Fgithub.com\u002Fmapbox\u002Fmcp-server)\n- [Turf.js Documentation](https:\u002F\u002Fturfjs.org\u002F) (Powers geometric tools)\n- [Mapbox Directions API](https:\u002F\u002Fdocs.mapbox.com\u002Fapi\u002Fnavigation\u002Fdirections\u002F)\n- [Mapbox Isochrone API](https:\u002F\u002Fdocs.mapbox.com\u002Fapi\u002Fnavigation\u002Fisochrone\u002F)\n- [Mapbox Matrix API](https:\u002F\u002Fdocs.mapbox.com\u002Fapi\u002Fnavigation\u002Fmatrix\u002F)\n- [Mapbox Optimization API](https:\u002F\u002Fdocs.mapbox.com\u002Fapi\u002Fnavigation\u002Foptimization\u002F)\n",{"data":31,"body":32},{"name":4,"description":6},{"type":33,"children":34},"root",[35,44,58,65,70,95,103,110,317,323,329,337,480,488,516,526,532,540,690,698,725,734,740,748,905,913,936,945,951,959,1093,1101,1128,1137,1143,1149,1157,1170,1178,1191,1199,1212,1221,1227,1346,1386,1392,1398,1406,1414,1452,1462,1468,1476,1483,1520,1535,1571,1583,1589,1597,1604,1631,1640,1646,1654,1661,1686,1695,1701,1709,1716,1751,1760,1766,1772,2120,2130,2136,2233,2242,2248,2455,2464,2470,2745,2755,2761,2766,2772,2782,2792,2798,2807,2816,2822,2831,2840,2846,2851,2860,2866,2871,2979,2985,2990,3155,3161,3167,3262,3268,3321,3327,3335,3358,3366,3399,3405,3410,3416,3680,3686,3756,3762,3770,3803,3809,3876],{"type":36,"tag":37,"props":38,"children":40},"element","h1",{"id":39},"mapbox-geospatial-operations-skill",[41],{"type":42,"value":43},"text","Mapbox Geospatial Operations Skill",{"type":36,"tag":45,"props":46,"children":47},"p",{},[48,50,56],{"type":42,"value":49},"Expert guidance for AI assistants on choosing the right geospatial tools from the Mapbox MCP Server. Focuses on selecting tools based on ",{"type":36,"tag":51,"props":52,"children":53},"strong",{},[54],{"type":42,"value":55},"what the problem requires",{"type":42,"value":57}," - geometric calculations vs routing, straight-line vs road network, and accuracy needs.",{"type":36,"tag":59,"props":60,"children":62},"h2",{"id":61},"core-principle-problem-type-determines-tool-choice",[63],{"type":42,"value":64},"Core Principle: Problem Type Determines Tool Choice",{"type":36,"tag":45,"props":66,"children":67},{},[68],{"type":42,"value":69},"The Mapbox MCP Server provides two categories of geospatial tools:",{"type":36,"tag":71,"props":72,"children":73},"ol",{},[74,85],{"type":36,"tag":75,"props":76,"children":77},"li",{},[78,83],{"type":36,"tag":51,"props":79,"children":80},{},[81],{"type":42,"value":82},"Offline Geometric Tools",{"type":42,"value":84}," - Use Turf.js for pure geometric\u002Fspatial calculations",{"type":36,"tag":75,"props":86,"children":87},{},[88,93],{"type":36,"tag":51,"props":89,"children":90},{},[91],{"type":42,"value":92},"Routing & Navigation APIs",{"type":42,"value":94}," - Use Mapbox APIs when you need real-world routing, traffic, or travel times",{"type":36,"tag":45,"props":96,"children":97},{},[98],{"type":36,"tag":51,"props":99,"children":100},{},[101],{"type":42,"value":102},"The key question: What does the problem actually require?",{"type":36,"tag":104,"props":105,"children":107},"h3",{"id":106},"decision-framework",[108],{"type":42,"value":109},"Decision Framework",{"type":36,"tag":111,"props":112,"children":113},"table",{},[114,138],{"type":36,"tag":115,"props":116,"children":117},"thead",{},[118],{"type":36,"tag":119,"props":120,"children":121},"tr",{},[122,128,133],{"type":36,"tag":123,"props":124,"children":125},"th",{},[126],{"type":42,"value":127},"Problem Characteristic",{"type":36,"tag":123,"props":129,"children":130},{},[131],{"type":42,"value":132},"Tool Category",{"type":36,"tag":123,"props":134,"children":135},{},[136],{"type":42,"value":137},"Why",{"type":36,"tag":139,"props":140,"children":141},"tbody",{},[142,166,189,209,231,253,273,295],{"type":36,"tag":119,"props":143,"children":144},{},[145,156,161],{"type":36,"tag":146,"props":147,"children":148},"td",{},[149,154],{"type":36,"tag":51,"props":150,"children":151},{},[152],{"type":42,"value":153},"Straight-line distance",{"type":42,"value":155}," (as the crow flies)",{"type":36,"tag":146,"props":157,"children":158},{},[159],{"type":42,"value":160},"Offline geometric",{"type":36,"tag":146,"props":162,"children":163},{},[164],{"type":42,"value":165},"Accurate for geometric distance",{"type":36,"tag":119,"props":167,"children":168},{},[169,179,184],{"type":36,"tag":146,"props":170,"children":171},{},[172,177],{"type":36,"tag":51,"props":173,"children":174},{},[175],{"type":42,"value":176},"Road\u002Fpath distance",{"type":42,"value":178}," (as the crow drives)",{"type":36,"tag":146,"props":180,"children":181},{},[182],{"type":42,"value":183},"Routing API",{"type":36,"tag":146,"props":185,"children":186},{},[187],{"type":42,"value":188},"Only routing APIs know road networks",{"type":36,"tag":119,"props":190,"children":191},{},[192,200,204],{"type":36,"tag":146,"props":193,"children":194},{},[195],{"type":36,"tag":51,"props":196,"children":197},{},[198],{"type":42,"value":199},"Travel time",{"type":36,"tag":146,"props":201,"children":202},{},[203],{"type":42,"value":183},{"type":36,"tag":146,"props":205,"children":206},{},[207],{"type":42,"value":208},"Requires routing with speed\u002Ftraffic data",{"type":36,"tag":119,"props":210,"children":211},{},[212,222,226],{"type":36,"tag":146,"props":213,"children":214},{},[215,220],{"type":36,"tag":51,"props":216,"children":217},{},[218],{"type":42,"value":219},"Point containment",{"type":42,"value":221}," (is X inside Y?)",{"type":36,"tag":146,"props":223,"children":224},{},[225],{"type":42,"value":160},{"type":36,"tag":146,"props":227,"children":228},{},[229],{"type":42,"value":230},"Pure geometric operation",{"type":36,"tag":119,"props":232,"children":233},{},[234,244,248],{"type":36,"tag":146,"props":235,"children":236},{},[237,242],{"type":36,"tag":51,"props":238,"children":239},{},[240],{"type":42,"value":241},"Geographic shapes",{"type":42,"value":243}," (buffers, centroids, areas)",{"type":36,"tag":146,"props":245,"children":246},{},[247],{"type":42,"value":160},{"type":36,"tag":146,"props":249,"children":250},{},[251],{"type":42,"value":252},"Mathematical\u002Fgeometric operations",{"type":36,"tag":119,"props":254,"children":255},{},[256,264,268],{"type":36,"tag":146,"props":257,"children":258},{},[259],{"type":36,"tag":51,"props":260,"children":261},{},[262],{"type":42,"value":263},"Traffic-aware routing",{"type":36,"tag":146,"props":265,"children":266},{},[267],{"type":42,"value":183},{"type":36,"tag":146,"props":269,"children":270},{},[271],{"type":42,"value":272},"Requires real-time traffic data",{"type":36,"tag":119,"props":274,"children":275},{},[276,286,290],{"type":36,"tag":146,"props":277,"children":278},{},[279,284],{"type":36,"tag":51,"props":280,"children":281},{},[282],{"type":42,"value":283},"Route optimization",{"type":42,"value":285}," (best order to visit)",{"type":36,"tag":146,"props":287,"children":288},{},[289],{"type":42,"value":183},{"type":36,"tag":146,"props":291,"children":292},{},[293],{"type":42,"value":294},"Complex routing algorithm",{"type":36,"tag":119,"props":296,"children":297},{},[298,308,312],{"type":36,"tag":146,"props":299,"children":300},{},[301,306],{"type":36,"tag":51,"props":302,"children":303},{},[304],{"type":42,"value":305},"High-frequency checks",{"type":42,"value":307}," (e.g., real-time geofencing)",{"type":36,"tag":146,"props":309,"children":310},{},[311],{"type":42,"value":160},{"type":36,"tag":146,"props":313,"children":314},{},[315],{"type":42,"value":316},"Instant response, no latency",{"type":36,"tag":59,"props":318,"children":320},{"id":319},"decision-matrices-by-use-case",[321],{"type":42,"value":322},"Decision Matrices by Use Case",{"type":36,"tag":104,"props":324,"children":326},{"id":325},"distance-calculations",[327],{"type":42,"value":328},"Distance Calculations",{"type":36,"tag":45,"props":330,"children":331},{},[332],{"type":36,"tag":51,"props":333,"children":334},{},[335],{"type":42,"value":336},"User asks: \"How far is X from Y?\"",{"type":36,"tag":111,"props":338,"children":339},{},[340,360],{"type":36,"tag":115,"props":341,"children":342},{},[343],{"type":36,"tag":119,"props":344,"children":345},{},[346,351,356],{"type":36,"tag":123,"props":347,"children":348},{},[349],{"type":42,"value":350},"What They Actually Mean",{"type":36,"tag":123,"props":352,"children":353},{},[354],{"type":42,"value":355},"Tool Choice",{"type":36,"tag":123,"props":357,"children":358},{},[359],{"type":42,"value":137},{"type":36,"tag":139,"props":361,"children":362},{},[363,386,408,429,457],{"type":36,"tag":119,"props":364,"children":365},{},[366,371,381],{"type":36,"tag":146,"props":367,"children":368},{},[369],{"type":42,"value":370},"Straight-line distance (as the crow flies)",{"type":36,"tag":146,"props":372,"children":373},{},[374],{"type":36,"tag":375,"props":376,"children":378},"code",{"className":377},[],[379],{"type":42,"value":380},"distance_tool",{"type":36,"tag":146,"props":382,"children":383},{},[384],{"type":42,"value":385},"Accurate for geometric distance, instant",{"type":36,"tag":119,"props":387,"children":388},{},[389,394,403],{"type":36,"tag":146,"props":390,"children":391},{},[392],{"type":42,"value":393},"Driving distance (as the crow drives)",{"type":36,"tag":146,"props":395,"children":396},{},[397],{"type":36,"tag":375,"props":398,"children":400},{"className":399},[],[401],{"type":42,"value":402},"directions_tool",{"type":36,"tag":146,"props":404,"children":405},{},[406],{"type":42,"value":407},"Only routing knows actual road distance",{"type":36,"tag":119,"props":409,"children":410},{},[411,416,424],{"type":36,"tag":146,"props":412,"children":413},{},[414],{"type":42,"value":415},"Walking\u002Fcycling distance (as the crow walks\u002Fbikes)",{"type":36,"tag":146,"props":417,"children":418},{},[419],{"type":36,"tag":375,"props":420,"children":422},{"className":421},[],[423],{"type":42,"value":402},{"type":36,"tag":146,"props":425,"children":426},{},[427],{"type":42,"value":428},"Need specific path network",{"type":36,"tag":119,"props":430,"children":431},{},[432,436,452],{"type":36,"tag":146,"props":433,"children":434},{},[435],{"type":42,"value":199},{"type":36,"tag":146,"props":437,"children":438},{},[439,444,446],{"type":36,"tag":375,"props":440,"children":442},{"className":441},[],[443],{"type":42,"value":402},{"type":42,"value":445}," or ",{"type":36,"tag":375,"props":447,"children":449},{"className":448},[],[450],{"type":42,"value":451},"matrix_tool",{"type":36,"tag":146,"props":453,"children":454},{},[455],{"type":42,"value":456},"Requires routing with speed data",{"type":36,"tag":119,"props":458,"children":459},{},[460,465,475],{"type":36,"tag":146,"props":461,"children":462},{},[463],{"type":42,"value":464},"Distance with current traffic",{"type":36,"tag":146,"props":466,"children":467},{},[468,473],{"type":36,"tag":375,"props":469,"children":471},{"className":470},[],[472],{"type":42,"value":402},{"type":42,"value":474}," (driving-traffic)",{"type":36,"tag":146,"props":476,"children":477},{},[478],{"type":42,"value":479},"Need real-time traffic consideration",{"type":36,"tag":45,"props":481,"children":482},{},[483],{"type":36,"tag":51,"props":484,"children":485},{},[486],{"type":42,"value":487},"Example: \"What's the distance between these 5 warehouses?\"",{"type":36,"tag":489,"props":490,"children":491},"ul",{},[492,504],{"type":36,"tag":75,"props":493,"children":494},{},[495,497,502],{"type":42,"value":496},"As the crow flies → ",{"type":36,"tag":375,"props":498,"children":500},{"className":499},[],[501],{"type":42,"value":380},{"type":42,"value":503}," (10 calculations, instant)",{"type":36,"tag":75,"props":505,"children":506},{},[507,509,514],{"type":42,"value":508},"As the crow drives → ",{"type":36,"tag":375,"props":510,"children":512},{"className":511},[],[513],{"type":42,"value":451},{"type":42,"value":515}," (5×5 matrix, one API call, returns actual route distances)",{"type":36,"tag":45,"props":517,"children":518},{},[519,524],{"type":36,"tag":51,"props":520,"children":521},{},[522],{"type":42,"value":523},"Key insight:",{"type":42,"value":525}," Use the tool that matches what \"distance\" means in context. Always clarify: crow flies or crow drives?",{"type":36,"tag":104,"props":527,"children":529},{"id":528},"proximity-and-containment",[530],{"type":42,"value":531},"Proximity and Containment",{"type":36,"tag":45,"props":533,"children":534},{},[535],{"type":36,"tag":51,"props":536,"children":537},{},[538],{"type":42,"value":539},"User asks: \"Which points are near\u002Finside this area?\"",{"type":36,"tag":111,"props":541,"children":542},{},[543,562],{"type":36,"tag":115,"props":544,"children":545},{},[546],{"type":36,"tag":119,"props":547,"children":548},{},[549,554,558],{"type":36,"tag":123,"props":550,"children":551},{},[552],{"type":42,"value":553},"Query Type",{"type":36,"tag":123,"props":555,"children":556},{},[557],{"type":42,"value":355},{"type":36,"tag":123,"props":559,"children":560},{},[561],{"type":42,"value":137},{"type":36,"tag":139,"props":563,"children":564},{},[565,588,618,639,660],{"type":36,"tag":119,"props":566,"children":567},{},[568,573,583],{"type":36,"tag":146,"props":569,"children":570},{},[571],{"type":42,"value":572},"\"Within X meters radius\"",{"type":36,"tag":146,"props":574,"children":575},{},[576,581],{"type":36,"tag":375,"props":577,"children":579},{"className":578},[],[580],{"type":42,"value":380},{"type":42,"value":582}," + filter",{"type":36,"tag":146,"props":584,"children":585},{},[586],{"type":42,"value":587},"Simple geometric radius",{"type":36,"tag":119,"props":589,"children":590},{},[591,596,613],{"type":36,"tag":146,"props":592,"children":593},{},[594],{"type":42,"value":595},"\"Within X minutes drive\"",{"type":36,"tag":146,"props":597,"children":598},{},[599,605,607],{"type":36,"tag":375,"props":600,"children":602},{"className":601},[],[603],{"type":42,"value":604},"isochrone_tool",{"type":42,"value":606}," → ",{"type":36,"tag":375,"props":608,"children":610},{"className":609},[],[611],{"type":42,"value":612},"point_in_polygon_tool",{"type":36,"tag":146,"props":614,"children":615},{},[616],{"type":42,"value":617},"Need routing for travel-time zone, then geometric containment",{"type":36,"tag":119,"props":619,"children":620},{},[621,626,634],{"type":36,"tag":146,"props":622,"children":623},{},[624],{"type":42,"value":625},"\"Inside this polygon\"",{"type":36,"tag":146,"props":627,"children":628},{},[629],{"type":36,"tag":375,"props":630,"children":632},{"className":631},[],[633],{"type":42,"value":612},{"type":36,"tag":146,"props":635,"children":636},{},[637],{"type":42,"value":638},"Pure geometric containment test",{"type":36,"tag":119,"props":640,"children":641},{},[642,647,655],{"type":36,"tag":146,"props":643,"children":644},{},[645],{"type":42,"value":646},"\"Reachable by car in 30 min\"",{"type":36,"tag":146,"props":648,"children":649},{},[650],{"type":36,"tag":375,"props":651,"children":653},{"className":652},[],[654],{"type":42,"value":604},{"type":36,"tag":146,"props":656,"children":657},{},[658],{"type":42,"value":659},"Requires routing + traffic",{"type":36,"tag":119,"props":661,"children":662},{},[663,668,685],{"type":36,"tag":146,"props":664,"children":665},{},[666],{"type":42,"value":667},"\"Nearest to this point\"",{"type":36,"tag":146,"props":669,"children":670},{},[671,676,678,683],{"type":36,"tag":375,"props":672,"children":674},{"className":673},[],[675],{"type":42,"value":380},{"type":42,"value":677}," (geometric) or ",{"type":36,"tag":375,"props":679,"children":681},{"className":680},[],[682],{"type":42,"value":451},{"type":42,"value":684}," (routed)",{"type":36,"tag":146,"props":686,"children":687},{},[688],{"type":42,"value":689},"Depends on definition of \"nearest\"",{"type":36,"tag":45,"props":691,"children":692},{},[693],{"type":36,"tag":51,"props":694,"children":695},{},[696],{"type":42,"value":697},"Example: \"Are these 200 addresses in our 30-minute delivery zone?\"",{"type":36,"tag":71,"props":699,"children":700},{},[701,713],{"type":36,"tag":75,"props":702,"children":703},{},[704,706,711],{"type":42,"value":705},"Create zone → ",{"type":36,"tag":375,"props":707,"children":709},{"className":708},[],[710],{"type":42,"value":604},{"type":42,"value":712}," (routing API - need travel time)",{"type":36,"tag":75,"props":714,"children":715},{},[716,718,723],{"type":42,"value":717},"Check addresses → ",{"type":36,"tag":375,"props":719,"children":721},{"className":720},[],[722],{"type":42,"value":612},{"type":42,"value":724}," (geometric - 200 instant checks)",{"type":36,"tag":45,"props":726,"children":727},{},[728,732],{"type":36,"tag":51,"props":729,"children":730},{},[731],{"type":42,"value":523},{"type":42,"value":733}," Routing for creating travel-time zones, geometric for containment checks",{"type":36,"tag":104,"props":735,"children":737},{"id":736},"routing-and-navigation",[738],{"type":42,"value":739},"Routing and Navigation",{"type":36,"tag":45,"props":741,"children":742},{},[743],{"type":36,"tag":51,"props":744,"children":745},{},[746],{"type":42,"value":747},"User asks: \"What's the best route?\"",{"type":36,"tag":111,"props":749,"children":750},{},[751,770],{"type":36,"tag":115,"props":752,"children":753},{},[754],{"type":36,"tag":119,"props":755,"children":756},{},[757,762,766],{"type":36,"tag":123,"props":758,"children":759},{},[760],{"type":42,"value":761},"Scenario",{"type":36,"tag":123,"props":763,"children":764},{},[765],{"type":42,"value":355},{"type":36,"tag":123,"props":767,"children":768},{},[769],{"type":42,"value":137},{"type":36,"tag":139,"props":771,"children":772},{},[773,794,816,838,860,882],{"type":36,"tag":119,"props":774,"children":775},{},[776,781,789],{"type":36,"tag":146,"props":777,"children":778},{},[779],{"type":42,"value":780},"A to B directions",{"type":36,"tag":146,"props":782,"children":783},{},[784],{"type":36,"tag":375,"props":785,"children":787},{"className":786},[],[788],{"type":42,"value":402},{"type":36,"tag":146,"props":790,"children":791},{},[792],{"type":42,"value":793},"Turn-by-turn routing",{"type":36,"tag":119,"props":795,"children":796},{},[797,802,811],{"type":36,"tag":146,"props":798,"children":799},{},[800],{"type":42,"value":801},"Optimal order for multiple stops",{"type":36,"tag":146,"props":803,"children":804},{},[805],{"type":36,"tag":375,"props":806,"children":808},{"className":807},[],[809],{"type":42,"value":810},"optimization_tool",{"type":36,"tag":146,"props":812,"children":813},{},[814],{"type":42,"value":815},"Solves traveling salesman problem",{"type":36,"tag":119,"props":817,"children":818},{},[819,824,833],{"type":36,"tag":146,"props":820,"children":821},{},[822],{"type":42,"value":823},"Clean GPS trace",{"type":36,"tag":146,"props":825,"children":826},{},[827],{"type":36,"tag":375,"props":828,"children":830},{"className":829},[],[831],{"type":42,"value":832},"map_matching_tool",{"type":36,"tag":146,"props":834,"children":835},{},[836],{"type":42,"value":837},"Snaps to road network",{"type":36,"tag":119,"props":839,"children":840},{},[841,846,855],{"type":36,"tag":146,"props":842,"children":843},{},[844],{"type":42,"value":845},"Just need bearing\u002Fcompass direction",{"type":36,"tag":146,"props":847,"children":848},{},[849],{"type":36,"tag":375,"props":850,"children":852},{"className":851},[],[853],{"type":42,"value":854},"bearing_tool",{"type":36,"tag":146,"props":856,"children":857},{},[858],{"type":42,"value":859},"Simple geometric calculation",{"type":36,"tag":119,"props":861,"children":862},{},[863,868,877],{"type":36,"tag":146,"props":864,"children":865},{},[866],{"type":42,"value":867},"Route with traffic",{"type":36,"tag":146,"props":869,"children":870},{},[871,876],{"type":36,"tag":375,"props":872,"children":874},{"className":873},[],[875],{"type":42,"value":402},{"type":42,"value":474},{"type":36,"tag":146,"props":878,"children":879},{},[880],{"type":42,"value":881},"Real-time traffic awareness",{"type":36,"tag":119,"props":883,"children":884},{},[885,890,900],{"type":36,"tag":146,"props":886,"children":887},{},[888],{"type":42,"value":889},"Fixed-order waypoints",{"type":36,"tag":146,"props":891,"children":892},{},[893,898],{"type":36,"tag":375,"props":894,"children":896},{"className":895},[],[897],{"type":42,"value":402},{"type":42,"value":899}," with waypoints",{"type":36,"tag":146,"props":901,"children":902},{},[903],{"type":42,"value":904},"Routing through specific points",{"type":36,"tag":45,"props":906,"children":907},{},[908],{"type":36,"tag":51,"props":909,"children":910},{},[911],{"type":42,"value":912},"Example: \"Navigate from hotel to airport\"",{"type":36,"tag":489,"props":914,"children":915},{},[916,926],{"type":36,"tag":75,"props":917,"children":918},{},[919,921],{"type":42,"value":920},"Need turn-by-turn → ",{"type":36,"tag":375,"props":922,"children":924},{"className":923},[],[925],{"type":42,"value":402},{"type":36,"tag":75,"props":927,"children":928},{},[929,931],{"type":42,"value":930},"Just need to know \"it's northeast\" → ",{"type":36,"tag":375,"props":932,"children":934},{"className":933},[],[935],{"type":42,"value":854},{"type":36,"tag":45,"props":937,"children":938},{},[939,943],{"type":36,"tag":51,"props":940,"children":941},{},[942],{"type":42,"value":523},{"type":42,"value":944}," Routing tools for actual navigation, geometric tools for directional info",{"type":36,"tag":104,"props":946,"children":948},{"id":947},"area-and-shape-operations",[949],{"type":42,"value":950},"Area and Shape Operations",{"type":36,"tag":45,"props":952,"children":953},{},[954],{"type":36,"tag":51,"props":955,"children":956},{},[957],{"type":42,"value":958},"User asks: \"Create a zone around this location\"",{"type":36,"tag":111,"props":960,"children":961},{},[962,981],{"type":36,"tag":115,"props":963,"children":964},{},[965],{"type":36,"tag":119,"props":966,"children":967},{},[968,973,977],{"type":36,"tag":123,"props":969,"children":970},{},[971],{"type":42,"value":972},"Requirement",{"type":36,"tag":123,"props":974,"children":975},{},[976],{"type":42,"value":355},{"type":36,"tag":123,"props":978,"children":979},{},[980],{"type":42,"value":137},{"type":36,"tag":139,"props":982,"children":983},{},[984,1006,1027,1049,1071],{"type":36,"tag":119,"props":985,"children":986},{},[987,992,1001],{"type":36,"tag":146,"props":988,"children":989},{},[990],{"type":42,"value":991},"Simple circular buffer",{"type":36,"tag":146,"props":993,"children":994},{},[995],{"type":36,"tag":375,"props":996,"children":998},{"className":997},[],[999],{"type":42,"value":1000},"buffer_tool",{"type":36,"tag":146,"props":1002,"children":1003},{},[1004],{"type":42,"value":1005},"Geometric circle\u002Fradius",{"type":36,"tag":119,"props":1007,"children":1008},{},[1009,1014,1022],{"type":36,"tag":146,"props":1010,"children":1011},{},[1012],{"type":42,"value":1013},"Travel-time zone",{"type":36,"tag":146,"props":1015,"children":1016},{},[1017],{"type":36,"tag":375,"props":1018,"children":1020},{"className":1019},[],[1021],{"type":42,"value":604},{"type":36,"tag":146,"props":1023,"children":1024},{},[1025],{"type":42,"value":1026},"Based on routing network",{"type":36,"tag":119,"props":1028,"children":1029},{},[1030,1035,1044],{"type":36,"tag":146,"props":1031,"children":1032},{},[1033],{"type":42,"value":1034},"Calculate area size",{"type":36,"tag":146,"props":1036,"children":1037},{},[1038],{"type":36,"tag":375,"props":1039,"children":1041},{"className":1040},[],[1042],{"type":42,"value":1043},"area_tool",{"type":36,"tag":146,"props":1045,"children":1046},{},[1047],{"type":42,"value":1048},"Geometric calculation",{"type":36,"tag":119,"props":1050,"children":1051},{},[1052,1057,1066],{"type":36,"tag":146,"props":1053,"children":1054},{},[1055],{"type":42,"value":1056},"Simplify complex boundary",{"type":36,"tag":146,"props":1058,"children":1059},{},[1060],{"type":36,"tag":375,"props":1061,"children":1063},{"className":1062},[],[1064],{"type":42,"value":1065},"simplify_tool",{"type":36,"tag":146,"props":1067,"children":1068},{},[1069],{"type":42,"value":1070},"Geometric simplification",{"type":36,"tag":119,"props":1072,"children":1073},{},[1074,1079,1088],{"type":36,"tag":146,"props":1075,"children":1076},{},[1077],{"type":42,"value":1078},"Find center of shape",{"type":36,"tag":146,"props":1080,"children":1081},{},[1082],{"type":36,"tag":375,"props":1083,"children":1085},{"className":1084},[],[1086],{"type":42,"value":1087},"centroid_tool",{"type":36,"tag":146,"props":1089,"children":1090},{},[1091],{"type":42,"value":1092},"Geometric centroid",{"type":36,"tag":45,"props":1094,"children":1095},{},[1096],{"type":36,"tag":51,"props":1097,"children":1098},{},[1099],{"type":42,"value":1100},"Example: \"Show 5km coverage around each store\"",{"type":36,"tag":489,"props":1102,"children":1103},{},[1104,1116],{"type":36,"tag":75,"props":1105,"children":1106},{},[1107,1109,1114],{"type":42,"value":1108},"5km radius → ",{"type":36,"tag":375,"props":1110,"children":1112},{"className":1111},[],[1113],{"type":42,"value":1000},{"type":42,"value":1115}," (geometric circles)",{"type":36,"tag":75,"props":1117,"children":1118},{},[1119,1121,1126],{"type":42,"value":1120},"\"What customers can reach in 15 min?\" → ",{"type":36,"tag":375,"props":1122,"children":1124},{"className":1123},[],[1125],{"type":42,"value":604},{"type":42,"value":1127}," (routing-based)",{"type":36,"tag":45,"props":1129,"children":1130},{},[1131,1135],{"type":36,"tag":51,"props":1132,"children":1133},{},[1134],{"type":42,"value":523},{"type":42,"value":1136}," Geometric tools for distance-based zones, routing tools for time-based zones",{"type":36,"tag":59,"props":1138,"children":1140},{"id":1139},"performance-and-scale-considerations",[1141],{"type":42,"value":1142},"Performance and Scale Considerations",{"type":36,"tag":104,"props":1144,"children":1146},{"id":1145},"when-volume-affects-tool-choice",[1147],{"type":42,"value":1148},"When Volume Affects Tool Choice",{"type":36,"tag":45,"props":1150,"children":1151},{},[1152],{"type":36,"tag":51,"props":1153,"children":1154},{},[1155],{"type":42,"value":1156},"Small operations (\u003C 100 calculations):",{"type":36,"tag":489,"props":1158,"children":1159},{},[1160,1165],{"type":36,"tag":75,"props":1161,"children":1162},{},[1163],{"type":42,"value":1164},"Geometric tools: Instant, iterate freely",{"type":36,"tag":75,"props":1166,"children":1167},{},[1168],{"type":42,"value":1169},"Routing APIs: Fast enough for most uses",{"type":36,"tag":45,"props":1171,"children":1172},{},[1173],{"type":36,"tag":51,"props":1174,"children":1175},{},[1176],{"type":42,"value":1177},"Medium operations (100-1,000 calculations):",{"type":36,"tag":489,"props":1179,"children":1180},{},[1181,1186],{"type":36,"tag":75,"props":1182,"children":1183},{},[1184],{"type":42,"value":1185},"Geometric tools: Still fast, no concerns",{"type":36,"tag":75,"props":1187,"children":1188},{},[1189],{"type":42,"value":1190},"Routing APIs: Consider batch operations (matrix_tool)",{"type":36,"tag":45,"props":1192,"children":1193},{},[1194],{"type":36,"tag":51,"props":1195,"children":1196},{},[1197],{"type":42,"value":1198},"Large operations (> 1,000 calculations):",{"type":36,"tag":489,"props":1200,"children":1201},{},[1202,1207],{"type":36,"tag":75,"props":1203,"children":1204},{},[1205],{"type":42,"value":1206},"Geometric tools: May need optimization but still fast",{"type":36,"tag":75,"props":1208,"children":1209},{},[1210],{"type":42,"value":1211},"Routing APIs: Definitely use batch tools (matrix_tool handles up to 25×25)",{"type":36,"tag":45,"props":1213,"children":1214},{},[1215,1219],{"type":36,"tag":51,"props":1216,"children":1217},{},[1218],{"type":42,"value":523},{"type":42,"value":1220}," Volume rarely affects geometric tool choice, but routing APIs have batch tools for efficiency",{"type":36,"tag":104,"props":1222,"children":1224},{"id":1223},"real-time-vs-batch",[1225],{"type":42,"value":1226},"Real-Time vs Batch",{"type":36,"tag":111,"props":1228,"children":1229},{},[1230,1250],{"type":36,"tag":115,"props":1231,"children":1232},{},[1233],{"type":36,"tag":119,"props":1234,"children":1235},{},[1236,1241,1246],{"type":36,"tag":123,"props":1237,"children":1238},{},[1239],{"type":42,"value":1240},"Use Case",{"type":36,"tag":123,"props":1242,"children":1243},{},[1244],{"type":42,"value":1245},"Approach",{"type":36,"tag":123,"props":1247,"children":1248},{},[1249],{"type":42,"value":355},{"type":36,"tag":139,"props":1251,"children":1252},{},[1253,1276,1303,1324],{"type":36,"tag":119,"props":1254,"children":1255},{},[1256,1261,1266],{"type":36,"tag":146,"props":1257,"children":1258},{},[1259],{"type":42,"value":1260},"Real-time geofencing (every second)",{"type":36,"tag":146,"props":1262,"children":1263},{},[1264],{"type":42,"value":1265},"Geometric checks",{"type":36,"tag":146,"props":1267,"children":1268},{},[1269,1274],{"type":36,"tag":375,"props":1270,"children":1272},{"className":1271},[],[1273],{"type":42,"value":612},{"type":42,"value":1275}," (instant)",{"type":36,"tag":119,"props":1277,"children":1278},{},[1279,1284,1289],{"type":36,"tag":146,"props":1280,"children":1281},{},[1282],{"type":42,"value":1283},"Route planning (one-time)",{"type":36,"tag":146,"props":1285,"children":1286},{},[1287],{"type":42,"value":1288},"Full routing",{"type":36,"tag":146,"props":1290,"children":1291},{},[1292,1297,1298],{"type":36,"tag":375,"props":1293,"children":1295},{"className":1294},[],[1296],{"type":42,"value":402},{"type":42,"value":445},{"type":36,"tag":375,"props":1299,"children":1301},{"className":1300},[],[1302],{"type":42,"value":810},{"type":36,"tag":119,"props":1304,"children":1305},{},[1306,1311,1316],{"type":36,"tag":146,"props":1307,"children":1308},{},[1309],{"type":42,"value":1310},"Periodic proximity checks",{"type":36,"tag":146,"props":1312,"children":1313},{},[1314],{"type":42,"value":1315},"Geometric distance",{"type":36,"tag":146,"props":1317,"children":1318},{},[1319],{"type":36,"tag":375,"props":1320,"children":1322},{"className":1321},[],[1323],{"type":42,"value":380},{"type":36,"tag":119,"props":1325,"children":1326},{},[1327,1332,1337],{"type":36,"tag":146,"props":1328,"children":1329},{},[1330],{"type":42,"value":1331},"Live traffic routing",{"type":36,"tag":146,"props":1333,"children":1334},{},[1335],{"type":42,"value":1336},"Routing with traffic",{"type":36,"tag":146,"props":1338,"children":1339},{},[1340,1345],{"type":36,"tag":375,"props":1341,"children":1343},{"className":1342},[],[1344],{"type":42,"value":402},{"type":42,"value":474},{"type":36,"tag":45,"props":1347,"children":1348},{},[1349,1354,1356,1362,1364,1369,1371,1376,1378,1384],{"type":36,"tag":51,"props":1350,"children":1351},{},[1352],{"type":42,"value":1353},"Architecture note for high-frequency geofencing:",{"type":42,"value":1355}," If the application calls containment checks at very high rates (e.g., 50 vehicles every 2 seconds = 25 checks\u002Fsecond), calling MCP tools over the network adds agent-reasoning overhead that makes it impractical. In those cases, recommend using Turf.js directly in-process (",{"type":36,"tag":375,"props":1357,"children":1359},{"className":1358},[],[1360],{"type":42,"value":1361},"turf.booleanPointInPolygon",{"type":42,"value":1363},") for the hot path, and reserve MCP tools for peripheral tasks like zone definition (",{"type":36,"tag":375,"props":1365,"children":1367},{"className":1366},[],[1368],{"type":42,"value":604},{"type":42,"value":1370},"), rerouting (",{"type":36,"tag":375,"props":1372,"children":1374},{"className":1373},[],[1375],{"type":42,"value":402},{"type":42,"value":1377},"), or visualization (",{"type":36,"tag":375,"props":1379,"children":1381},{"className":1380},[],[1382],{"type":42,"value":1383},"static_map_image_tool",{"type":42,"value":1385},").",{"type":36,"tag":59,"props":1387,"children":1389},{"id":1388},"common-scenarios-and-optimal-approaches",[1390],{"type":42,"value":1391},"Common Scenarios and Optimal Approaches",{"type":36,"tag":104,"props":1393,"children":1395},{"id":1394},"scenario-1-store-locator",[1396],{"type":42,"value":1397},"Scenario 1: Store Locator",{"type":36,"tag":45,"props":1399,"children":1400},{},[1401],{"type":36,"tag":51,"props":1402,"children":1403},{},[1404],{"type":42,"value":1405},"User: \"Find the closest store and show 5km coverage\"",{"type":36,"tag":45,"props":1407,"children":1408},{},[1409],{"type":36,"tag":51,"props":1410,"children":1411},{},[1412],{"type":42,"value":1413},"Optimal approach:",{"type":36,"tag":71,"props":1415,"children":1416},{},[1417,1430,1442],{"type":36,"tag":75,"props":1418,"children":1419},{},[1420,1422,1428],{"type":42,"value":1421},"Search stores → ",{"type":36,"tag":375,"props":1423,"children":1425},{"className":1424},[],[1426],{"type":42,"value":1427},"category_search_tool",{"type":42,"value":1429}," (returns distances automatically)",{"type":36,"tag":75,"props":1431,"children":1432},{},[1433,1435,1440],{"type":42,"value":1434},"Create coverage zone → ",{"type":36,"tag":375,"props":1436,"children":1438},{"className":1437},[],[1439],{"type":42,"value":1000},{"type":42,"value":1441}," (5km geometric circle)",{"type":36,"tag":75,"props":1443,"children":1444},{},[1445,1447],{"type":42,"value":1446},"Visualize → ",{"type":36,"tag":375,"props":1448,"children":1450},{"className":1449},[],[1451],{"type":42,"value":1383},{"type":36,"tag":45,"props":1453,"children":1454},{},[1455,1460],{"type":36,"tag":51,"props":1456,"children":1457},{},[1458],{"type":42,"value":1459},"Why:",{"type":42,"value":1461}," Search already gives distances; geometric buffer for simple radius",{"type":36,"tag":104,"props":1463,"children":1465},{"id":1464},"scenario-2-delivery-route-optimization",[1466],{"type":42,"value":1467},"Scenario 2: Delivery Route Optimization",{"type":36,"tag":45,"props":1469,"children":1470},{},[1471],{"type":36,"tag":51,"props":1472,"children":1473},{},[1474],{"type":42,"value":1475},"User: \"Optimize delivery to 8 addresses \u002F stops\"",{"type":36,"tag":45,"props":1477,"children":1478},{},[1479],{"type":36,"tag":51,"props":1480,"children":1481},{},[1482],{"type":42,"value":1413},{"type":36,"tag":71,"props":1484,"children":1485},{},[1486,1504],{"type":36,"tag":75,"props":1487,"children":1488},{},[1489,1494,1496,1502],{"type":36,"tag":51,"props":1490,"children":1491},{},[1492],{"type":42,"value":1493},"Geocode addresses (if needed)",{"type":42,"value":1495}," → Use ",{"type":36,"tag":375,"props":1497,"children":1499},{"className":1498},[],[1500],{"type":42,"value":1501},"search_and_geocode_tool",{"type":42,"value":1503}," to convert any street addresses to coordinates. Even when coordinates are already provided, mention this as an optional pre-step — real-world delivery lists often contain a mix of addresses and coordinates.",{"type":36,"tag":75,"props":1505,"children":1506},{},[1507,1512,1513,1518],{"type":36,"tag":51,"props":1508,"children":1509},{},[1510],{"type":42,"value":1511},"Optimize route",{"type":42,"value":606},{"type":36,"tag":375,"props":1514,"children":1516},{"className":1515},[],[1517],{"type":42,"value":810},{"type":42,"value":1519}," (TSP solver — reorders stops to minimize total drive time)",{"type":36,"tag":45,"props":1521,"children":1522},{},[1523],{"type":36,"tag":51,"props":1524,"children":1525},{},[1526,1528,1533],{"type":42,"value":1527},"Why ",{"type":36,"tag":375,"props":1529,"children":1531},{"className":1530},[],[1532],{"type":42,"value":810},{"type":42,"value":1534}," and NOT these alternatives:",{"type":36,"tag":489,"props":1536,"children":1537},{},[1538,1551],{"type":36,"tag":75,"props":1539,"children":1540},{},[1541,1549],{"type":36,"tag":51,"props":1542,"children":1543},{},[1544],{"type":36,"tag":375,"props":1545,"children":1547},{"className":1546},[],[1548],{"type":42,"value":402},{"type":42,"value":1550}," only routes A → B (or through fixed-order waypoints). It does NOT reorder stops — if you pass 8 stops, it routes them in the order given, which is almost never optimal.",{"type":36,"tag":75,"props":1552,"children":1553},{},[1554,1562,1564,1569],{"type":36,"tag":51,"props":1555,"children":1556},{},[1557],{"type":36,"tag":375,"props":1558,"children":1560},{"className":1559},[],[1561],{"type":42,"value":451},{"type":42,"value":1563}," gives travel times between all pairs of stops (8×8 = 64 values), but it does NOT compute the optimal ordering. You'd need to solve TSP yourself on top of the matrix — ",{"type":36,"tag":375,"props":1565,"children":1567},{"className":1566},[],[1568],{"type":42,"value":810},{"type":42,"value":1570}," does this for you in one call.",{"type":36,"tag":45,"props":1572,"children":1573},{},[1574,1576,1581],{"type":42,"value":1575},"Always mention ",{"type":36,"tag":375,"props":1577,"children":1579},{"className":1578},[],[1580],{"type":42,"value":1501},{"type":42,"value":1582}," as a useful companion for geocoding delivery addresses before optimization.",{"type":36,"tag":104,"props":1584,"children":1586},{"id":1585},"scenario-3-service-area-validation",[1587],{"type":42,"value":1588},"Scenario 3: Service Area Validation",{"type":36,"tag":45,"props":1590,"children":1591},{},[1592],{"type":36,"tag":51,"props":1593,"children":1594},{},[1595],{"type":42,"value":1596},"User: \"Which of these 200 addresses can we deliver to in 30 minutes?\"",{"type":36,"tag":45,"props":1598,"children":1599},{},[1600],{"type":36,"tag":51,"props":1601,"children":1602},{},[1603],{"type":42,"value":1413},{"type":36,"tag":71,"props":1605,"children":1606},{},[1607,1619],{"type":36,"tag":75,"props":1608,"children":1609},{},[1610,1612,1617],{"type":42,"value":1611},"Create delivery zone → ",{"type":36,"tag":375,"props":1613,"children":1615},{"className":1614},[],[1616],{"type":42,"value":604},{"type":42,"value":1618}," (30-minute driving)",{"type":36,"tag":75,"props":1620,"children":1621},{},[1622,1624,1629],{"type":42,"value":1623},"Check each address → ",{"type":36,"tag":375,"props":1625,"children":1627},{"className":1626},[],[1628],{"type":42,"value":612},{"type":42,"value":1630}," (200 geometric checks)",{"type":36,"tag":45,"props":1632,"children":1633},{},[1634,1638],{"type":36,"tag":51,"props":1635,"children":1636},{},[1637],{"type":42,"value":1459},{"type":42,"value":1639}," Routing for accurate travel-time zone, geometric for fast containment checks",{"type":36,"tag":104,"props":1641,"children":1643},{"id":1642},"scenario-4-gps-trace-analysis",[1644],{"type":42,"value":1645},"Scenario 4: GPS Trace Analysis",{"type":36,"tag":45,"props":1647,"children":1648},{},[1649],{"type":36,"tag":51,"props":1650,"children":1651},{},[1652],{"type":42,"value":1653},"User: \"How long was this bike ride?\"",{"type":36,"tag":45,"props":1655,"children":1656},{},[1657],{"type":36,"tag":51,"props":1658,"children":1659},{},[1660],{"type":42,"value":1413},{"type":36,"tag":71,"props":1662,"children":1663},{},[1664,1676],{"type":36,"tag":75,"props":1665,"children":1666},{},[1667,1669,1674],{"type":42,"value":1668},"Clean GPS trace → ",{"type":36,"tag":375,"props":1670,"children":1672},{"className":1671},[],[1673],{"type":42,"value":832},{"type":42,"value":1675}," (snap to bike paths)",{"type":36,"tag":75,"props":1677,"children":1678},{},[1679,1681],{"type":42,"value":1680},"Get distance → Use API response or calculate with ",{"type":36,"tag":375,"props":1682,"children":1684},{"className":1683},[],[1685],{"type":42,"value":380},{"type":36,"tag":45,"props":1687,"children":1688},{},[1689,1693],{"type":36,"tag":51,"props":1690,"children":1691},{},[1692],{"type":42,"value":1459},{"type":42,"value":1694}," Need road\u002Fpath matching; distance calculation either way works",{"type":36,"tag":104,"props":1696,"children":1698},{"id":1697},"scenario-5-coverage-analysis",[1699],{"type":42,"value":1700},"Scenario 5: Coverage Analysis",{"type":36,"tag":45,"props":1702,"children":1703},{},[1704],{"type":36,"tag":51,"props":1705,"children":1706},{},[1707],{"type":42,"value":1708},"User: \"What's our total service area?\"",{"type":36,"tag":45,"props":1710,"children":1711},{},[1712],{"type":36,"tag":51,"props":1713,"children":1714},{},[1715],{"type":42,"value":1413},{"type":36,"tag":71,"props":1717,"children":1718},{},[1719,1729,1739],{"type":36,"tag":75,"props":1720,"children":1721},{},[1722,1724],{"type":42,"value":1723},"Create buffers around each location → ",{"type":36,"tag":375,"props":1725,"children":1727},{"className":1726},[],[1728],{"type":42,"value":1000},{"type":36,"tag":75,"props":1730,"children":1731},{},[1732,1734],{"type":42,"value":1733},"Calculate total area → ",{"type":36,"tag":375,"props":1735,"children":1737},{"className":1736},[],[1738],{"type":42,"value":1043},{"type":36,"tag":75,"props":1740,"children":1741},{},[1742,1744,1749],{"type":42,"value":1743},"Or, if time-based → ",{"type":36,"tag":375,"props":1745,"children":1747},{"className":1746},[],[1748],{"type":42,"value":604},{"type":42,"value":1750}," for each location",{"type":36,"tag":45,"props":1752,"children":1753},{},[1754,1758],{"type":36,"tag":51,"props":1755,"children":1756},{},[1757],{"type":42,"value":1459},{"type":42,"value":1759}," Geometric for distance-based coverage, routing for time-based",{"type":36,"tag":59,"props":1761,"children":1763},{"id":1762},"anti-patterns-using-the-wrong-tool-type",[1764],{"type":42,"value":1765},"Anti-Patterns: Using the Wrong Tool Type",{"type":36,"tag":104,"props":1767,"children":1769},{"id":1768},"dont-use-geometric-tools-for-routing-questions",[1770],{"type":42,"value":1771},"❌ Don't: Use geometric tools for routing questions",{"type":36,"tag":1773,"props":1774,"children":1779},"pre",{"className":1775,"code":1776,"language":1777,"meta":1778,"style":1778},"language-javascript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F WRONG: User asks \"how long to drive there?\"\ndistance_tool({ from: A, to: B });\n\u002F\u002F Returns 10km as the crow flies, but actual drive is 15km\n\n\u002F\u002F CORRECT: Need routing for driving distance\ndirections_tool({\n  coordinates: [\n    { longitude: A[0], latitude: A[1] },\n    { longitude: B[0], latitude: B[1] }\n  ],\n  routing_profile: 'mapbox\u002Fdriving'\n});\n\u002F\u002F Returns actual road distance and drive time as the crow drives\n","javascript","",[1780],{"type":36,"tag":375,"props":1781,"children":1782},{"__ignoreMap":1778},[1783,1795,1866,1875,1885,1894,1911,1929,1995,2053,2066,2095,2111],{"type":36,"tag":1784,"props":1785,"children":1788},"span",{"class":1786,"line":1787},"line",1,[1789],{"type":36,"tag":1784,"props":1790,"children":1792},{"style":1791},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[1793],{"type":42,"value":1794},"\u002F\u002F WRONG: User asks \"how long to drive there?\"\n",{"type":36,"tag":1784,"props":1796,"children":1798},{"class":1786,"line":1797},2,[1799,1804,1810,1816,1822,1827,1832,1837,1842,1846,1851,1856,1861],{"type":36,"tag":1784,"props":1800,"children":1802},{"style":1801},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[1803],{"type":42,"value":380},{"type":36,"tag":1784,"props":1805,"children":1807},{"style":1806},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1808],{"type":42,"value":1809},"(",{"type":36,"tag":1784,"props":1811,"children":1813},{"style":1812},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[1814],{"type":42,"value":1815},"{",{"type":36,"tag":1784,"props":1817,"children":1819},{"style":1818},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[1820],{"type":42,"value":1821}," from",{"type":36,"tag":1784,"props":1823,"children":1824},{"style":1812},[1825],{"type":42,"value":1826},":",{"type":36,"tag":1784,"props":1828,"children":1829},{"style":1806},[1830],{"type":42,"value":1831}," A",{"type":36,"tag":1784,"props":1833,"children":1834},{"style":1812},[1835],{"type":42,"value":1836},",",{"type":36,"tag":1784,"props":1838,"children":1839},{"style":1818},[1840],{"type":42,"value":1841}," to",{"type":36,"tag":1784,"props":1843,"children":1844},{"style":1812},[1845],{"type":42,"value":1826},{"type":36,"tag":1784,"props":1847,"children":1848},{"style":1806},[1849],{"type":42,"value":1850}," B ",{"type":36,"tag":1784,"props":1852,"children":1853},{"style":1812},[1854],{"type":42,"value":1855},"}",{"type":36,"tag":1784,"props":1857,"children":1858},{"style":1806},[1859],{"type":42,"value":1860},")",{"type":36,"tag":1784,"props":1862,"children":1863},{"style":1812},[1864],{"type":42,"value":1865},";\n",{"type":36,"tag":1784,"props":1867,"children":1869},{"class":1786,"line":1868},3,[1870],{"type":36,"tag":1784,"props":1871,"children":1872},{"style":1791},[1873],{"type":42,"value":1874},"\u002F\u002F Returns 10km as the crow flies, but actual drive is 15km\n",{"type":36,"tag":1784,"props":1876,"children":1878},{"class":1786,"line":1877},4,[1879],{"type":36,"tag":1784,"props":1880,"children":1882},{"emptyLinePlaceholder":1881},true,[1883],{"type":42,"value":1884},"\n",{"type":36,"tag":1784,"props":1886,"children":1888},{"class":1786,"line":1887},5,[1889],{"type":36,"tag":1784,"props":1890,"children":1891},{"style":1791},[1892],{"type":42,"value":1893},"\u002F\u002F CORRECT: Need routing for driving distance\n",{"type":36,"tag":1784,"props":1895,"children":1897},{"class":1786,"line":1896},6,[1898,1902,1906],{"type":36,"tag":1784,"props":1899,"children":1900},{"style":1801},[1901],{"type":42,"value":402},{"type":36,"tag":1784,"props":1903,"children":1904},{"style":1806},[1905],{"type":42,"value":1809},{"type":36,"tag":1784,"props":1907,"children":1908},{"style":1812},[1909],{"type":42,"value":1910},"{\n",{"type":36,"tag":1784,"props":1912,"children":1914},{"class":1786,"line":1913},7,[1915,1920,1924],{"type":36,"tag":1784,"props":1916,"children":1917},{"style":1818},[1918],{"type":42,"value":1919},"  coordinates",{"type":36,"tag":1784,"props":1921,"children":1922},{"style":1812},[1923],{"type":42,"value":1826},{"type":36,"tag":1784,"props":1925,"children":1926},{"style":1806},[1927],{"type":42,"value":1928}," [\n",{"type":36,"tag":1784,"props":1930,"children":1932},{"class":1786,"line":1931},8,[1933,1938,1943,1947,1952,1958,1963,1967,1972,1976,1980,1985,1990],{"type":36,"tag":1784,"props":1934,"children":1935},{"style":1812},[1936],{"type":42,"value":1937},"    {",{"type":36,"tag":1784,"props":1939,"children":1940},{"style":1818},[1941],{"type":42,"value":1942}," longitude",{"type":36,"tag":1784,"props":1944,"children":1945},{"style":1812},[1946],{"type":42,"value":1826},{"type":36,"tag":1784,"props":1948,"children":1949},{"style":1806},[1950],{"type":42,"value":1951}," A[",{"type":36,"tag":1784,"props":1953,"children":1955},{"style":1954},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1956],{"type":42,"value":1957},"0",{"type":36,"tag":1784,"props":1959,"children":1960},{"style":1806},[1961],{"type":42,"value":1962},"]",{"type":36,"tag":1784,"props":1964,"children":1965},{"style":1812},[1966],{"type":42,"value":1836},{"type":36,"tag":1784,"props":1968,"children":1969},{"style":1818},[1970],{"type":42,"value":1971}," latitude",{"type":36,"tag":1784,"props":1973,"children":1974},{"style":1812},[1975],{"type":42,"value":1826},{"type":36,"tag":1784,"props":1977,"children":1978},{"style":1806},[1979],{"type":42,"value":1951},{"type":36,"tag":1784,"props":1981,"children":1982},{"style":1954},[1983],{"type":42,"value":1984},"1",{"type":36,"tag":1784,"props":1986,"children":1987},{"style":1806},[1988],{"type":42,"value":1989},"] ",{"type":36,"tag":1784,"props":1991,"children":1992},{"style":1812},[1993],{"type":42,"value":1994},"},\n",{"type":36,"tag":1784,"props":1996,"children":1998},{"class":1786,"line":1997},9,[1999,2003,2007,2011,2016,2020,2024,2028,2032,2036,2040,2044,2048],{"type":36,"tag":1784,"props":2000,"children":2001},{"style":1812},[2002],{"type":42,"value":1937},{"type":36,"tag":1784,"props":2004,"children":2005},{"style":1818},[2006],{"type":42,"value":1942},{"type":36,"tag":1784,"props":2008,"children":2009},{"style":1812},[2010],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2012,"children":2013},{"style":1806},[2014],{"type":42,"value":2015}," B[",{"type":36,"tag":1784,"props":2017,"children":2018},{"style":1954},[2019],{"type":42,"value":1957},{"type":36,"tag":1784,"props":2021,"children":2022},{"style":1806},[2023],{"type":42,"value":1962},{"type":36,"tag":1784,"props":2025,"children":2026},{"style":1812},[2027],{"type":42,"value":1836},{"type":36,"tag":1784,"props":2029,"children":2030},{"style":1818},[2031],{"type":42,"value":1971},{"type":36,"tag":1784,"props":2033,"children":2034},{"style":1812},[2035],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2037,"children":2038},{"style":1806},[2039],{"type":42,"value":2015},{"type":36,"tag":1784,"props":2041,"children":2042},{"style":1954},[2043],{"type":42,"value":1984},{"type":36,"tag":1784,"props":2045,"children":2046},{"style":1806},[2047],{"type":42,"value":1989},{"type":36,"tag":1784,"props":2049,"children":2050},{"style":1812},[2051],{"type":42,"value":2052},"}\n",{"type":36,"tag":1784,"props":2054,"children":2055},{"class":1786,"line":24},[2056,2061],{"type":36,"tag":1784,"props":2057,"children":2058},{"style":1806},[2059],{"type":42,"value":2060},"  ]",{"type":36,"tag":1784,"props":2062,"children":2063},{"style":1812},[2064],{"type":42,"value":2065},",\n",{"type":36,"tag":1784,"props":2067,"children":2069},{"class":1786,"line":2068},11,[2070,2075,2079,2084,2090],{"type":36,"tag":1784,"props":2071,"children":2072},{"style":1818},[2073],{"type":42,"value":2074},"  routing_profile",{"type":36,"tag":1784,"props":2076,"children":2077},{"style":1812},[2078],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2080,"children":2081},{"style":1812},[2082],{"type":42,"value":2083}," '",{"type":36,"tag":1784,"props":2085,"children":2087},{"style":2086},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[2088],{"type":42,"value":2089},"mapbox\u002Fdriving",{"type":36,"tag":1784,"props":2091,"children":2092},{"style":1812},[2093],{"type":42,"value":2094},"'\n",{"type":36,"tag":1784,"props":2096,"children":2098},{"class":1786,"line":2097},12,[2099,2103,2107],{"type":36,"tag":1784,"props":2100,"children":2101},{"style":1812},[2102],{"type":42,"value":1855},{"type":36,"tag":1784,"props":2104,"children":2105},{"style":1806},[2106],{"type":42,"value":1860},{"type":36,"tag":1784,"props":2108,"children":2109},{"style":1812},[2110],{"type":42,"value":1865},{"type":36,"tag":1784,"props":2112,"children":2114},{"class":1786,"line":2113},13,[2115],{"type":36,"tag":1784,"props":2116,"children":2117},{"style":1791},[2118],{"type":42,"value":2119},"\u002F\u002F Returns actual road distance and drive time as the crow drives\n",{"type":36,"tag":45,"props":2121,"children":2122},{},[2123,2128],{"type":36,"tag":51,"props":2124,"children":2125},{},[2126],{"type":42,"value":2127},"Why wrong:",{"type":42,"value":2129}," As the crow flies ≠ as the crow drives",{"type":36,"tag":104,"props":2131,"children":2133},{"id":2132},"dont-use-routing-apis-for-geometric-operations",[2134],{"type":42,"value":2135},"❌ Don't: Use routing APIs for geometric operations",{"type":36,"tag":1773,"props":2137,"children":2139},{"className":1775,"code":2138,"language":1777,"meta":1778,"style":1778},"\u002F\u002F WRONG: Check if point is in polygon\n\u002F\u002F (Can't do this with routing APIs)\n\n\u002F\u002F CORRECT: Pure geometric operation\npoint_in_polygon_tool({ point: location, polygon: boundary });\n",[2140],{"type":36,"tag":375,"props":2141,"children":2142},{"__ignoreMap":1778},[2143,2151,2159,2166,2174],{"type":36,"tag":1784,"props":2144,"children":2145},{"class":1786,"line":1787},[2146],{"type":36,"tag":1784,"props":2147,"children":2148},{"style":1791},[2149],{"type":42,"value":2150},"\u002F\u002F WRONG: Check if point is in polygon\n",{"type":36,"tag":1784,"props":2152,"children":2153},{"class":1786,"line":1797},[2154],{"type":36,"tag":1784,"props":2155,"children":2156},{"style":1791},[2157],{"type":42,"value":2158},"\u002F\u002F (Can't do this with routing APIs)\n",{"type":36,"tag":1784,"props":2160,"children":2161},{"class":1786,"line":1868},[2162],{"type":36,"tag":1784,"props":2163,"children":2164},{"emptyLinePlaceholder":1881},[2165],{"type":42,"value":1884},{"type":36,"tag":1784,"props":2167,"children":2168},{"class":1786,"line":1877},[2169],{"type":36,"tag":1784,"props":2170,"children":2171},{"style":1791},[2172],{"type":42,"value":2173},"\u002F\u002F CORRECT: Pure geometric operation\n",{"type":36,"tag":1784,"props":2175,"children":2176},{"class":1786,"line":1887},[2177,2181,2185,2189,2194,2198,2203,2207,2212,2216,2221,2225,2229],{"type":36,"tag":1784,"props":2178,"children":2179},{"style":1801},[2180],{"type":42,"value":612},{"type":36,"tag":1784,"props":2182,"children":2183},{"style":1806},[2184],{"type":42,"value":1809},{"type":36,"tag":1784,"props":2186,"children":2187},{"style":1812},[2188],{"type":42,"value":1815},{"type":36,"tag":1784,"props":2190,"children":2191},{"style":1818},[2192],{"type":42,"value":2193}," point",{"type":36,"tag":1784,"props":2195,"children":2196},{"style":1812},[2197],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2199,"children":2200},{"style":1806},[2201],{"type":42,"value":2202}," location",{"type":36,"tag":1784,"props":2204,"children":2205},{"style":1812},[2206],{"type":42,"value":1836},{"type":36,"tag":1784,"props":2208,"children":2209},{"style":1818},[2210],{"type":42,"value":2211}," polygon",{"type":36,"tag":1784,"props":2213,"children":2214},{"style":1812},[2215],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2217,"children":2218},{"style":1806},[2219],{"type":42,"value":2220}," boundary ",{"type":36,"tag":1784,"props":2222,"children":2223},{"style":1812},[2224],{"type":42,"value":1855},{"type":36,"tag":1784,"props":2226,"children":2227},{"style":1806},[2228],{"type":42,"value":1860},{"type":36,"tag":1784,"props":2230,"children":2231},{"style":1812},[2232],{"type":42,"value":1865},{"type":36,"tag":45,"props":2234,"children":2235},{},[2236,2240],{"type":36,"tag":51,"props":2237,"children":2238},{},[2239],{"type":42,"value":2127},{"type":42,"value":2241}," Routing APIs don't do geometric containment",{"type":36,"tag":104,"props":2243,"children":2245},{"id":2244},"dont-confuse-near-with-reachable",[2246],{"type":42,"value":2247},"❌ Don't: Confuse \"near\" with \"reachable\"",{"type":36,"tag":1773,"props":2249,"children":2251},{"className":1775,"code":2250,"language":1777,"meta":1778,"style":1778},"\u002F\u002F User asks: \"What's reachable in 20 minutes?\"\n\n\u002F\u002F WRONG: 20-minute distance at average speed\ndistance_tool + calculate 20min * avg_speed\n\n\u002F\u002F CORRECT: Actual routing with road network\nisochrone_tool({\n  coordinates: {longitude: startLng, latitude: startLat},\n  contours_minutes: [20],\n  profile: \"mapbox\u002Fdriving\"\n})\n",[2252],{"type":36,"tag":375,"props":2253,"children":2254},{"__ignoreMap":1778},[2255,2263,2270,2278,2306,2313,2321,2336,2387,2417,2443],{"type":36,"tag":1784,"props":2256,"children":2257},{"class":1786,"line":1787},[2258],{"type":36,"tag":1784,"props":2259,"children":2260},{"style":1791},[2261],{"type":42,"value":2262},"\u002F\u002F User asks: \"What's reachable in 20 minutes?\"\n",{"type":36,"tag":1784,"props":2264,"children":2265},{"class":1786,"line":1797},[2266],{"type":36,"tag":1784,"props":2267,"children":2268},{"emptyLinePlaceholder":1881},[2269],{"type":42,"value":1884},{"type":36,"tag":1784,"props":2271,"children":2272},{"class":1786,"line":1868},[2273],{"type":36,"tag":1784,"props":2274,"children":2275},{"style":1791},[2276],{"type":42,"value":2277},"\u002F\u002F WRONG: 20-minute distance at average speed\n",{"type":36,"tag":1784,"props":2279,"children":2280},{"class":1786,"line":1877},[2281,2286,2291,2296,2301],{"type":36,"tag":1784,"props":2282,"children":2283},{"style":1806},[2284],{"type":42,"value":2285},"distance_tool ",{"type":36,"tag":1784,"props":2287,"children":2288},{"style":1812},[2289],{"type":42,"value":2290},"+",{"type":36,"tag":1784,"props":2292,"children":2293},{"style":1806},[2294],{"type":42,"value":2295}," calculate 20min ",{"type":36,"tag":1784,"props":2297,"children":2298},{"style":1812},[2299],{"type":42,"value":2300},"*",{"type":36,"tag":1784,"props":2302,"children":2303},{"style":1806},[2304],{"type":42,"value":2305}," avg_speed\n",{"type":36,"tag":1784,"props":2307,"children":2308},{"class":1786,"line":1887},[2309],{"type":36,"tag":1784,"props":2310,"children":2311},{"emptyLinePlaceholder":1881},[2312],{"type":42,"value":1884},{"type":36,"tag":1784,"props":2314,"children":2315},{"class":1786,"line":1896},[2316],{"type":36,"tag":1784,"props":2317,"children":2318},{"style":1791},[2319],{"type":42,"value":2320},"\u002F\u002F CORRECT: Actual routing with road network\n",{"type":36,"tag":1784,"props":2322,"children":2323},{"class":1786,"line":1913},[2324,2328,2332],{"type":36,"tag":1784,"props":2325,"children":2326},{"style":1801},[2327],{"type":42,"value":604},{"type":36,"tag":1784,"props":2329,"children":2330},{"style":1806},[2331],{"type":42,"value":1809},{"type":36,"tag":1784,"props":2333,"children":2334},{"style":1812},[2335],{"type":42,"value":1910},{"type":36,"tag":1784,"props":2337,"children":2338},{"class":1786,"line":1931},[2339,2343,2347,2352,2357,2361,2366,2370,2374,2378,2383],{"type":36,"tag":1784,"props":2340,"children":2341},{"style":1818},[2342],{"type":42,"value":1919},{"type":36,"tag":1784,"props":2344,"children":2345},{"style":1812},[2346],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2348,"children":2349},{"style":1812},[2350],{"type":42,"value":2351}," {",{"type":36,"tag":1784,"props":2353,"children":2354},{"style":1818},[2355],{"type":42,"value":2356},"longitude",{"type":36,"tag":1784,"props":2358,"children":2359},{"style":1812},[2360],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2362,"children":2363},{"style":1806},[2364],{"type":42,"value":2365}," startLng",{"type":36,"tag":1784,"props":2367,"children":2368},{"style":1812},[2369],{"type":42,"value":1836},{"type":36,"tag":1784,"props":2371,"children":2372},{"style":1818},[2373],{"type":42,"value":1971},{"type":36,"tag":1784,"props":2375,"children":2376},{"style":1812},[2377],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2379,"children":2380},{"style":1806},[2381],{"type":42,"value":2382}," startLat",{"type":36,"tag":1784,"props":2384,"children":2385},{"style":1812},[2386],{"type":42,"value":1994},{"type":36,"tag":1784,"props":2388,"children":2389},{"class":1786,"line":1997},[2390,2395,2399,2404,2409,2413],{"type":36,"tag":1784,"props":2391,"children":2392},{"style":1818},[2393],{"type":42,"value":2394},"  contours_minutes",{"type":36,"tag":1784,"props":2396,"children":2397},{"style":1812},[2398],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2400,"children":2401},{"style":1806},[2402],{"type":42,"value":2403}," [",{"type":36,"tag":1784,"props":2405,"children":2406},{"style":1954},[2407],{"type":42,"value":2408},"20",{"type":36,"tag":1784,"props":2410,"children":2411},{"style":1806},[2412],{"type":42,"value":1962},{"type":36,"tag":1784,"props":2414,"children":2415},{"style":1812},[2416],{"type":42,"value":2065},{"type":36,"tag":1784,"props":2418,"children":2419},{"class":1786,"line":24},[2420,2425,2429,2434,2438],{"type":36,"tag":1784,"props":2421,"children":2422},{"style":1818},[2423],{"type":42,"value":2424},"  profile",{"type":36,"tag":1784,"props":2426,"children":2427},{"style":1812},[2428],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2430,"children":2431},{"style":1812},[2432],{"type":42,"value":2433}," \"",{"type":36,"tag":1784,"props":2435,"children":2436},{"style":2086},[2437],{"type":42,"value":2089},{"type":36,"tag":1784,"props":2439,"children":2440},{"style":1812},[2441],{"type":42,"value":2442},"\"\n",{"type":36,"tag":1784,"props":2444,"children":2445},{"class":1786,"line":2068},[2446,2450],{"type":36,"tag":1784,"props":2447,"children":2448},{"style":1812},[2449],{"type":42,"value":1855},{"type":36,"tag":1784,"props":2451,"children":2452},{"style":1806},[2453],{"type":42,"value":2454},")\n",{"type":36,"tag":45,"props":2456,"children":2457},{},[2458,2462],{"type":36,"tag":51,"props":2459,"children":2460},{},[2461],{"type":42,"value":2127},{"type":42,"value":2463}," Roads aren't straight lines; traffic varies",{"type":36,"tag":104,"props":2465,"children":2467},{"id":2466},"dont-use-routing-when-bearing-is-sufficient",[2468],{"type":42,"value":2469},"❌ Don't: Use routing when bearing is sufficient",{"type":36,"tag":1773,"props":2471,"children":2473},{"className":1775,"code":2472,"language":1777,"meta":1778,"style":1778},"\u002F\u002F User asks: \"Which direction is the airport?\"\n\n\u002F\u002F OVERCOMPLICATED: Full routing\ndirections_tool({\n  coordinates: [\n    { longitude: hotel[0], latitude: hotel[1] },\n    { longitude: airport[0], latitude: airport[1] }\n  ]\n});\n\n\u002F\u002F BETTER: Just need bearing\nbearing_tool({ from: hotel, to: airport });\n\u002F\u002F Returns: \"Northeast (45°)\"\n",[2474],{"type":36,"tag":375,"props":2475,"children":2476},{"__ignoreMap":1778},[2477,2485,2492,2500,2515,2530,2586,2642,2650,2665,2672,2680,2737],{"type":36,"tag":1784,"props":2478,"children":2479},{"class":1786,"line":1787},[2480],{"type":36,"tag":1784,"props":2481,"children":2482},{"style":1791},[2483],{"type":42,"value":2484},"\u002F\u002F User asks: \"Which direction is the airport?\"\n",{"type":36,"tag":1784,"props":2486,"children":2487},{"class":1786,"line":1797},[2488],{"type":36,"tag":1784,"props":2489,"children":2490},{"emptyLinePlaceholder":1881},[2491],{"type":42,"value":1884},{"type":36,"tag":1784,"props":2493,"children":2494},{"class":1786,"line":1868},[2495],{"type":36,"tag":1784,"props":2496,"children":2497},{"style":1791},[2498],{"type":42,"value":2499},"\u002F\u002F OVERCOMPLICATED: Full routing\n",{"type":36,"tag":1784,"props":2501,"children":2502},{"class":1786,"line":1877},[2503,2507,2511],{"type":36,"tag":1784,"props":2504,"children":2505},{"style":1801},[2506],{"type":42,"value":402},{"type":36,"tag":1784,"props":2508,"children":2509},{"style":1806},[2510],{"type":42,"value":1809},{"type":36,"tag":1784,"props":2512,"children":2513},{"style":1812},[2514],{"type":42,"value":1910},{"type":36,"tag":1784,"props":2516,"children":2517},{"class":1786,"line":1887},[2518,2522,2526],{"type":36,"tag":1784,"props":2519,"children":2520},{"style":1818},[2521],{"type":42,"value":1919},{"type":36,"tag":1784,"props":2523,"children":2524},{"style":1812},[2525],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2527,"children":2528},{"style":1806},[2529],{"type":42,"value":1928},{"type":36,"tag":1784,"props":2531,"children":2532},{"class":1786,"line":1896},[2533,2537,2541,2545,2550,2554,2558,2562,2566,2570,2574,2578,2582],{"type":36,"tag":1784,"props":2534,"children":2535},{"style":1812},[2536],{"type":42,"value":1937},{"type":36,"tag":1784,"props":2538,"children":2539},{"style":1818},[2540],{"type":42,"value":1942},{"type":36,"tag":1784,"props":2542,"children":2543},{"style":1812},[2544],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2546,"children":2547},{"style":1806},[2548],{"type":42,"value":2549}," hotel[",{"type":36,"tag":1784,"props":2551,"children":2552},{"style":1954},[2553],{"type":42,"value":1957},{"type":36,"tag":1784,"props":2555,"children":2556},{"style":1806},[2557],{"type":42,"value":1962},{"type":36,"tag":1784,"props":2559,"children":2560},{"style":1812},[2561],{"type":42,"value":1836},{"type":36,"tag":1784,"props":2563,"children":2564},{"style":1818},[2565],{"type":42,"value":1971},{"type":36,"tag":1784,"props":2567,"children":2568},{"style":1812},[2569],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2571,"children":2572},{"style":1806},[2573],{"type":42,"value":2549},{"type":36,"tag":1784,"props":2575,"children":2576},{"style":1954},[2577],{"type":42,"value":1984},{"type":36,"tag":1784,"props":2579,"children":2580},{"style":1806},[2581],{"type":42,"value":1989},{"type":36,"tag":1784,"props":2583,"children":2584},{"style":1812},[2585],{"type":42,"value":1994},{"type":36,"tag":1784,"props":2587,"children":2588},{"class":1786,"line":1913},[2589,2593,2597,2601,2606,2610,2614,2618,2622,2626,2630,2634,2638],{"type":36,"tag":1784,"props":2590,"children":2591},{"style":1812},[2592],{"type":42,"value":1937},{"type":36,"tag":1784,"props":2594,"children":2595},{"style":1818},[2596],{"type":42,"value":1942},{"type":36,"tag":1784,"props":2598,"children":2599},{"style":1812},[2600],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2602,"children":2603},{"style":1806},[2604],{"type":42,"value":2605}," airport[",{"type":36,"tag":1784,"props":2607,"children":2608},{"style":1954},[2609],{"type":42,"value":1957},{"type":36,"tag":1784,"props":2611,"children":2612},{"style":1806},[2613],{"type":42,"value":1962},{"type":36,"tag":1784,"props":2615,"children":2616},{"style":1812},[2617],{"type":42,"value":1836},{"type":36,"tag":1784,"props":2619,"children":2620},{"style":1818},[2621],{"type":42,"value":1971},{"type":36,"tag":1784,"props":2623,"children":2624},{"style":1812},[2625],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2627,"children":2628},{"style":1806},[2629],{"type":42,"value":2605},{"type":36,"tag":1784,"props":2631,"children":2632},{"style":1954},[2633],{"type":42,"value":1984},{"type":36,"tag":1784,"props":2635,"children":2636},{"style":1806},[2637],{"type":42,"value":1989},{"type":36,"tag":1784,"props":2639,"children":2640},{"style":1812},[2641],{"type":42,"value":2052},{"type":36,"tag":1784,"props":2643,"children":2644},{"class":1786,"line":1931},[2645],{"type":36,"tag":1784,"props":2646,"children":2647},{"style":1806},[2648],{"type":42,"value":2649},"  ]\n",{"type":36,"tag":1784,"props":2651,"children":2652},{"class":1786,"line":1997},[2653,2657,2661],{"type":36,"tag":1784,"props":2654,"children":2655},{"style":1812},[2656],{"type":42,"value":1855},{"type":36,"tag":1784,"props":2658,"children":2659},{"style":1806},[2660],{"type":42,"value":1860},{"type":36,"tag":1784,"props":2662,"children":2663},{"style":1812},[2664],{"type":42,"value":1865},{"type":36,"tag":1784,"props":2666,"children":2667},{"class":1786,"line":24},[2668],{"type":36,"tag":1784,"props":2669,"children":2670},{"emptyLinePlaceholder":1881},[2671],{"type":42,"value":1884},{"type":36,"tag":1784,"props":2673,"children":2674},{"class":1786,"line":2068},[2675],{"type":36,"tag":1784,"props":2676,"children":2677},{"style":1791},[2678],{"type":42,"value":2679},"\u002F\u002F BETTER: Just need bearing\n",{"type":36,"tag":1784,"props":2681,"children":2682},{"class":1786,"line":2097},[2683,2687,2691,2695,2699,2703,2708,2712,2716,2720,2725,2729,2733],{"type":36,"tag":1784,"props":2684,"children":2685},{"style":1801},[2686],{"type":42,"value":854},{"type":36,"tag":1784,"props":2688,"children":2689},{"style":1806},[2690],{"type":42,"value":1809},{"type":36,"tag":1784,"props":2692,"children":2693},{"style":1812},[2694],{"type":42,"value":1815},{"type":36,"tag":1784,"props":2696,"children":2697},{"style":1818},[2698],{"type":42,"value":1821},{"type":36,"tag":1784,"props":2700,"children":2701},{"style":1812},[2702],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2704,"children":2705},{"style":1806},[2706],{"type":42,"value":2707}," hotel",{"type":36,"tag":1784,"props":2709,"children":2710},{"style":1812},[2711],{"type":42,"value":1836},{"type":36,"tag":1784,"props":2713,"children":2714},{"style":1818},[2715],{"type":42,"value":1841},{"type":36,"tag":1784,"props":2717,"children":2718},{"style":1812},[2719],{"type":42,"value":1826},{"type":36,"tag":1784,"props":2721,"children":2722},{"style":1806},[2723],{"type":42,"value":2724}," airport ",{"type":36,"tag":1784,"props":2726,"children":2727},{"style":1812},[2728],{"type":42,"value":1855},{"type":36,"tag":1784,"props":2730,"children":2731},{"style":1806},[2732],{"type":42,"value":1860},{"type":36,"tag":1784,"props":2734,"children":2735},{"style":1812},[2736],{"type":42,"value":1865},{"type":36,"tag":1784,"props":2738,"children":2739},{"class":1786,"line":2113},[2740],{"type":36,"tag":1784,"props":2741,"children":2742},{"style":1791},[2743],{"type":42,"value":2744},"\u002F\u002F Returns: \"Northeast (45°)\"\n",{"type":36,"tag":45,"props":2746,"children":2747},{},[2748,2753],{"type":36,"tag":51,"props":2749,"children":2750},{},[2751],{"type":42,"value":2752},"Why better:",{"type":42,"value":2754}," Simpler, instant, answers the actual question",{"type":36,"tag":59,"props":2756,"children":2758},{"id":2757},"hybrid-approaches-combining-tool-types",[2759],{"type":42,"value":2760},"Hybrid Approaches: Combining Tool Types",{"type":36,"tag":45,"props":2762,"children":2763},{},[2764],{"type":42,"value":2765},"Some problems benefit from using both geometric and routing tools:",{"type":36,"tag":104,"props":2767,"children":2769},{"id":2768},"pattern-1-routing-geometric-filter",[2770],{"type":42,"value":2771},"Pattern 1: Routing + Geometric Filter",{"type":36,"tag":1773,"props":2773,"children":2777},{"className":2774,"code":2776,"language":42},[2775],"language-text","1. directions_tool → Get route geometry\n2. buffer_tool → Create corridor around route\n3. category_search_tool → Find POIs in corridor\n4. point_in_polygon_tool → Filter to those actually along route\n",[2778],{"type":36,"tag":375,"props":2779,"children":2780},{"__ignoreMap":1778},[2781],{"type":42,"value":2776},{"type":36,"tag":45,"props":2783,"children":2784},{},[2785,2790],{"type":36,"tag":51,"props":2786,"children":2787},{},[2788],{"type":42,"value":2789},"Use case:",{"type":42,"value":2791}," \"Find gas stations along my route\"",{"type":36,"tag":104,"props":2793,"children":2795},{"id":2794},"pattern-2-routing-distance-calculation",[2796],{"type":42,"value":2797},"Pattern 2: Routing + Distance Calculation",{"type":36,"tag":1773,"props":2799,"children":2802},{"className":2800,"code":2801,"language":42},[2775],"1. category_search_tool → Find 10 nearby locations\n2. distance_tool → Calculate straight-line distances (geometric)\n3. For top 3, use directions_tool → Get actual driving time\n",[2803],{"type":36,"tag":375,"props":2804,"children":2805},{"__ignoreMap":1778},[2806],{"type":42,"value":2801},{"type":36,"tag":45,"props":2808,"children":2809},{},[2810,2814],{"type":36,"tag":51,"props":2811,"children":2812},{},[2813],{"type":42,"value":2789},{"type":42,"value":2815}," Quickly narrow down, then get precise routing for finalists",{"type":36,"tag":104,"props":2817,"children":2819},{"id":2818},"pattern-3-isochrone-containment",[2820],{"type":42,"value":2821},"Pattern 3: Isochrone + Containment",{"type":36,"tag":1773,"props":2823,"children":2826},{"className":2824,"code":2825,"language":42},[2775],"1. isochrone_tool → Create travel-time zone (routing)\n2. point_in_polygon_tool → Check hundreds of addresses (geometric)\n",[2827],{"type":36,"tag":375,"props":2828,"children":2829},{"__ignoreMap":1778},[2830],{"type":42,"value":2825},{"type":36,"tag":45,"props":2832,"children":2833},{},[2834,2838],{"type":36,"tag":51,"props":2835,"children":2836},{},[2837],{"type":42,"value":2789},{"type":42,"value":2839}," \"Which customers are in our delivery zone?\"",{"type":36,"tag":59,"props":2841,"children":2843},{"id":2842},"decision-algorithm",[2844],{"type":42,"value":2845},"Decision Algorithm",{"type":36,"tag":45,"props":2847,"children":2848},{},[2849],{"type":42,"value":2850},"When user asks a geospatial question:",{"type":36,"tag":1773,"props":2852,"children":2855},{"className":2853,"code":2854,"language":42},[2775],"1. Does it require routing, roads, or travel times?\n   YES → Use routing API (directions, matrix, isochrone, optimization)\n   NO → Continue\n\n2. Does it require traffic awareness?\n   YES → Use directions_tool or isochrone_tool with traffic profile\n   NO → Continue\n\n3. Is it a geometric\u002Fspatial operation?\n   - Distance between points (straight-line) → distance_tool\n   - Point containment → point_in_polygon_tool\n   - Area calculation → area_tool\n   - Buffer\u002Fzone → buffer_tool\n   - Direction\u002Fbearing → bearing_tool\n   - Geometric center → centroid_tool\n   - Bounding box → bounding_box_tool\n   - Simplification → simplify_tool\n\n4. Is it a search\u002Fdiscovery operation?\n   YES → Use search tools (search_and_geocode, category_search)\n",[2856],{"type":36,"tag":375,"props":2857,"children":2858},{"__ignoreMap":1778},[2859],{"type":42,"value":2854},{"type":36,"tag":59,"props":2861,"children":2863},{"id":2862},"key-decision-questions",[2864],{"type":42,"value":2865},"Key Decision Questions",{"type":36,"tag":45,"props":2867,"children":2868},{},[2869],{"type":42,"value":2870},"Before choosing a tool, ask:",{"type":36,"tag":71,"props":2872,"children":2873},{},[2874,2895,2916,2937,2958],{"type":36,"tag":75,"props":2875,"children":2876},{},[2877,2882],{"type":36,"tag":51,"props":2878,"children":2879},{},[2880],{"type":42,"value":2881},"Does \"distance\" mean as the crow flies or as the crow drives?",{"type":36,"tag":489,"props":2883,"children":2884},{},[2885,2890],{"type":36,"tag":75,"props":2886,"children":2887},{},[2888],{"type":42,"value":2889},"As the crow flies (straight-line) → geometric tools",{"type":36,"tag":75,"props":2891,"children":2892},{},[2893],{"type":42,"value":2894},"As the crow drives (road distance) → routing APIs",{"type":36,"tag":75,"props":2896,"children":2897},{},[2898,2903],{"type":36,"tag":51,"props":2899,"children":2900},{},[2901],{"type":42,"value":2902},"Does the user need travel time?",{"type":36,"tag":489,"props":2904,"children":2905},{},[2906,2911],{"type":36,"tag":75,"props":2907,"children":2908},{},[2909],{"type":42,"value":2910},"Yes → routing APIs (only they know speeds\u002Ftraffic)",{"type":36,"tag":75,"props":2912,"children":2913},{},[2914],{"type":42,"value":2915},"No → geometric tools may suffice",{"type":36,"tag":75,"props":2917,"children":2918},{},[2919,2924],{"type":36,"tag":51,"props":2920,"children":2921},{},[2922],{"type":42,"value":2923},"Is this about roads\u002Fpaths or pure spatial relationships?",{"type":36,"tag":489,"props":2925,"children":2926},{},[2927,2932],{"type":36,"tag":75,"props":2928,"children":2929},{},[2930],{"type":42,"value":2931},"Roads\u002Fpaths → routing APIs",{"type":36,"tag":75,"props":2933,"children":2934},{},[2935],{"type":42,"value":2936},"Spatial relationships → geometric tools",{"type":36,"tag":75,"props":2938,"children":2939},{},[2940,2945],{"type":36,"tag":51,"props":2941,"children":2942},{},[2943],{"type":42,"value":2944},"Does this need to happen in real-time with low latency?",{"type":36,"tag":489,"props":2946,"children":2947},{},[2948,2953],{"type":36,"tag":75,"props":2949,"children":2950},{},[2951],{"type":42,"value":2952},"Yes + geometric problem → offline tools (instant)",{"type":36,"tag":75,"props":2954,"children":2955},{},[2956],{"type":42,"value":2957},"Yes + routing problem → use routing APIs (still fast)",{"type":36,"tag":75,"props":2959,"children":2960},{},[2961,2966],{"type":36,"tag":51,"props":2962,"children":2963},{},[2964],{"type":42,"value":2965},"Is accuracy critical, or is approximation OK?",{"type":36,"tag":489,"props":2967,"children":2968},{},[2969,2974],{"type":36,"tag":75,"props":2970,"children":2971},{},[2972],{"type":42,"value":2973},"Critical + routing → routing APIs",{"type":36,"tag":75,"props":2975,"children":2976},{},[2977],{"type":42,"value":2978},"Approximation OK → geometric tools may work",{"type":36,"tag":59,"props":2980,"children":2982},{"id":2981},"terminology-guide",[2983],{"type":42,"value":2984},"Terminology Guide",{"type":36,"tag":45,"props":2986,"children":2987},{},[2988],{"type":42,"value":2989},"Understanding what users mean:",{"type":36,"tag":111,"props":2991,"children":2992},{},[2993,3014],{"type":36,"tag":115,"props":2994,"children":2995},{},[2996],{"type":36,"tag":119,"props":2997,"children":2998},{},[2999,3004,3009],{"type":36,"tag":123,"props":3000,"children":3001},{},[3002],{"type":42,"value":3003},"User Says",{"type":36,"tag":123,"props":3005,"children":3006},{},[3007],{"type":42,"value":3008},"Usually Means",{"type":36,"tag":123,"props":3010,"children":3011},{},[3012],{"type":42,"value":3013},"Tool Type",{"type":36,"tag":139,"props":3015,"children":3016},{},[3017,3035,3052,3070,3088,3105,3122,3138],{"type":36,"tag":119,"props":3018,"children":3019},{},[3020,3025,3030],{"type":36,"tag":146,"props":3021,"children":3022},{},[3023],{"type":42,"value":3024},"\"Distance\"",{"type":36,"tag":146,"props":3026,"children":3027},{},[3028],{"type":42,"value":3029},"Context-dependent! Ask: crow flies or crow drives?",{"type":36,"tag":146,"props":3031,"children":3032},{},[3033],{"type":42,"value":3034},"Varies",{"type":36,"tag":119,"props":3036,"children":3037},{},[3038,3043,3048],{"type":36,"tag":146,"props":3039,"children":3040},{},[3041],{"type":42,"value":3042},"\"How far\"",{"type":36,"tag":146,"props":3044,"children":3045},{},[3046],{"type":42,"value":3047},"Often as the crow drives (road distance)",{"type":36,"tag":146,"props":3049,"children":3050},{},[3051],{"type":42,"value":183},{"type":36,"tag":119,"props":3053,"children":3054},{},[3055,3060,3065],{"type":36,"tag":146,"props":3056,"children":3057},{},[3058],{"type":42,"value":3059},"\"Nearby\"",{"type":36,"tag":146,"props":3061,"children":3062},{},[3063],{"type":42,"value":3064},"Usually as the crow flies (straight-line radius)",{"type":36,"tag":146,"props":3066,"children":3067},{},[3068],{"type":42,"value":3069},"Geometric",{"type":36,"tag":119,"props":3071,"children":3072},{},[3073,3078,3083],{"type":36,"tag":146,"props":3074,"children":3075},{},[3076],{"type":42,"value":3077},"\"Close\"",{"type":36,"tag":146,"props":3079,"children":3080},{},[3081],{"type":42,"value":3082},"Could be either - clarify!",{"type":36,"tag":146,"props":3084,"children":3085},{},[3086],{"type":42,"value":3087},"Ask",{"type":36,"tag":119,"props":3089,"children":3090},{},[3091,3096,3101],{"type":36,"tag":146,"props":3092,"children":3093},{},[3094],{"type":42,"value":3095},"\"Reachable\"",{"type":36,"tag":146,"props":3097,"children":3098},{},[3099],{"type":42,"value":3100},"Travel-time based (crow drives with traffic)",{"type":36,"tag":146,"props":3102,"children":3103},{},[3104],{"type":42,"value":183},{"type":36,"tag":119,"props":3106,"children":3107},{},[3108,3113,3118],{"type":36,"tag":146,"props":3109,"children":3110},{},[3111],{"type":42,"value":3112},"\"Inside\u002Fcontains\"",{"type":36,"tag":146,"props":3114,"children":3115},{},[3116],{"type":42,"value":3117},"Geometric containment",{"type":36,"tag":146,"props":3119,"children":3120},{},[3121],{"type":42,"value":3069},{"type":36,"tag":119,"props":3123,"children":3124},{},[3125,3130,3134],{"type":36,"tag":146,"props":3126,"children":3127},{},[3128],{"type":42,"value":3129},"\"Navigate\u002Fdirections\"",{"type":36,"tag":146,"props":3131,"children":3132},{},[3133],{"type":42,"value":793},{"type":36,"tag":146,"props":3135,"children":3136},{},[3137],{"type":42,"value":183},{"type":36,"tag":119,"props":3139,"children":3140},{},[3141,3146,3151],{"type":36,"tag":146,"props":3142,"children":3143},{},[3144],{"type":42,"value":3145},"\"Bearing\u002Fdirection\"",{"type":36,"tag":146,"props":3147,"children":3148},{},[3149],{"type":42,"value":3150},"Compass direction (crow flies)",{"type":36,"tag":146,"props":3152,"children":3153},{},[3154],{"type":42,"value":3069},{"type":36,"tag":59,"props":3156,"children":3158},{"id":3157},"quick-reference",[3159],{"type":42,"value":3160},"Quick Reference",{"type":36,"tag":104,"props":3162,"children":3164},{"id":3163},"geometric-operations-offline-tools",[3165],{"type":42,"value":3166},"Geometric Operations (Offline Tools)",{"type":36,"tag":489,"props":3168,"children":3169},{},[3170,3180,3190,3201,3211,3221,3231,3241,3252],{"type":36,"tag":75,"props":3171,"children":3172},{},[3173,3178],{"type":36,"tag":375,"props":3174,"children":3176},{"className":3175},[],[3177],{"type":42,"value":380},{"type":42,"value":3179}," - Straight-line distance between two points",{"type":36,"tag":75,"props":3181,"children":3182},{},[3183,3188],{"type":36,"tag":375,"props":3184,"children":3186},{"className":3185},[],[3187],{"type":42,"value":854},{"type":42,"value":3189}," - Compass direction from A to B",{"type":36,"tag":75,"props":3191,"children":3192},{},[3193,3199],{"type":36,"tag":375,"props":3194,"children":3196},{"className":3195},[],[3197],{"type":42,"value":3198},"midpoint_tool",{"type":42,"value":3200}," - Midpoint between two points",{"type":36,"tag":75,"props":3202,"children":3203},{},[3204,3209],{"type":36,"tag":375,"props":3205,"children":3207},{"className":3206},[],[3208],{"type":42,"value":612},{"type":42,"value":3210}," - Is point inside polygon?",{"type":36,"tag":75,"props":3212,"children":3213},{},[3214,3219],{"type":36,"tag":375,"props":3215,"children":3217},{"className":3216},[],[3218],{"type":42,"value":1043},{"type":42,"value":3220}," - Calculate polygon area",{"type":36,"tag":75,"props":3222,"children":3223},{},[3224,3229],{"type":36,"tag":375,"props":3225,"children":3227},{"className":3226},[],[3228],{"type":42,"value":1000},{"type":42,"value":3230}," - Create circular buffer\u002Fzone",{"type":36,"tag":75,"props":3232,"children":3233},{},[3234,3239],{"type":36,"tag":375,"props":3235,"children":3237},{"className":3236},[],[3238],{"type":42,"value":1087},{"type":42,"value":3240}," - Geometric center of polygon",{"type":36,"tag":75,"props":3242,"children":3243},{},[3244,3250],{"type":36,"tag":375,"props":3245,"children":3247},{"className":3246},[],[3248],{"type":42,"value":3249},"bbox_tool",{"type":42,"value":3251}," - Min\u002Fmax coordinates of geometry",{"type":36,"tag":75,"props":3253,"children":3254},{},[3255,3260],{"type":36,"tag":375,"props":3256,"children":3258},{"className":3257},[],[3259],{"type":42,"value":1065},{"type":42,"value":3261}," - Reduce geometry complexity",{"type":36,"tag":104,"props":3263,"children":3265},{"id":3264},"routing-navigation-apis",[3266],{"type":42,"value":3267},"Routing & Navigation (APIs)",{"type":36,"tag":489,"props":3269,"children":3270},{},[3271,3281,3291,3301,3311],{"type":36,"tag":75,"props":3272,"children":3273},{},[3274,3279],{"type":36,"tag":375,"props":3275,"children":3277},{"className":3276},[],[3278],{"type":42,"value":402},{"type":42,"value":3280}," - Turn-by-turn routing",{"type":36,"tag":75,"props":3282,"children":3283},{},[3284,3289],{"type":36,"tag":375,"props":3285,"children":3287},{"className":3286},[],[3288],{"type":42,"value":451},{"type":42,"value":3290}," - Many-to-many travel times",{"type":36,"tag":75,"props":3292,"children":3293},{},[3294,3299],{"type":36,"tag":375,"props":3295,"children":3297},{"className":3296},[],[3298],{"type":42,"value":810},{"type":42,"value":3300}," - Route optimization (TSP)",{"type":36,"tag":75,"props":3302,"children":3303},{},[3304,3309],{"type":36,"tag":375,"props":3305,"children":3307},{"className":3306},[],[3308],{"type":42,"value":604},{"type":42,"value":3310}," - Travel-time zones",{"type":36,"tag":75,"props":3312,"children":3313},{},[3314,3319],{"type":36,"tag":375,"props":3315,"children":3317},{"className":3316},[],[3318],{"type":42,"value":832},{"type":42,"value":3320}," - Snap GPS to roads",{"type":36,"tag":104,"props":3322,"children":3324},{"id":3323},"when-to-use-each-category",[3325],{"type":42,"value":3326},"When to Use Each Category",{"type":36,"tag":45,"props":3328,"children":3329},{},[3330],{"type":36,"tag":51,"props":3331,"children":3332},{},[3333],{"type":42,"value":3334},"Use Geometric Tools When:",{"type":36,"tag":489,"props":3336,"children":3337},{},[3338,3343,3348,3353],{"type":36,"tag":75,"props":3339,"children":3340},{},[3341],{"type":42,"value":3342},"Problem is spatial\u002Fmathematical (containment, area, bearing)",{"type":36,"tag":75,"props":3344,"children":3345},{},[3346],{"type":42,"value":3347},"Straight-line distance is appropriate",{"type":36,"tag":75,"props":3349,"children":3350},{},[3351],{"type":42,"value":3352},"Need instant results for real-time checks",{"type":36,"tag":75,"props":3354,"children":3355},{},[3356],{"type":42,"value":3357},"Pure geometry (no roads\u002Ftraffic involved)",{"type":36,"tag":45,"props":3359,"children":3360},{},[3361],{"type":36,"tag":51,"props":3362,"children":3363},{},[3364],{"type":42,"value":3365},"Use Routing APIs When:",{"type":36,"tag":489,"props":3367,"children":3368},{},[3369,3374,3379,3384,3389,3394],{"type":36,"tag":75,"props":3370,"children":3371},{},[3372],{"type":42,"value":3373},"Need actual driving\u002Fwalking\u002Fcycling distances",{"type":36,"tag":75,"props":3375,"children":3376},{},[3377],{"type":42,"value":3378},"Need travel times",{"type":36,"tag":75,"props":3380,"children":3381},{},[3382],{"type":42,"value":3383},"Need to consider road networks",{"type":36,"tag":75,"props":3385,"children":3386},{},[3387],{"type":42,"value":3388},"Need traffic awareness",{"type":36,"tag":75,"props":3390,"children":3391},{},[3392],{"type":42,"value":3393},"Need route optimization",{"type":36,"tag":75,"props":3395,"children":3396},{},[3397],{"type":42,"value":3398},"Need turn-by-turn directions",{"type":36,"tag":59,"props":3400,"children":3402},{"id":3401},"rest-api-honesty-directions-isochrone",[3403],{"type":42,"value":3404},"REST API honesty (Directions \u002F Isochrone)",{"type":36,"tag":45,"props":3406,"children":3407},{},[3408],{"type":42,"value":3409},"When generating browser demos against Mapbox REST APIs (not only MCP tools):",{"type":36,"tag":104,"props":3411,"children":3413},{"id":3412},"directions-use-the-route-object-metrics",[3414],{"type":42,"value":3415},"Directions — use the route object metrics",{"type":36,"tag":1773,"props":3417,"children":3419},{"className":1775,"code":3418,"language":1777,"meta":1778,"style":1778},"const route = data.routes[0];\n\u002F\u002F GOOD — meters \u002F seconds from the API\nstats.textContent =\n  `Distance ${(route.distance \u002F 1000).toFixed(2)} km · ` + `Duration ${Math.round(route.duration \u002F 60)} min`;\n\n\u002F\u002F BAD — cosmetic labels or hardcoded ETAs that look like a working demo\n\u002F\u002F \"Len 0.00 km · Time 2 min\" \u002F Math.round(120\u002F60)\n",[3420],{"type":36,"tag":375,"props":3421,"children":3422},{"__ignoreMap":1778},[3423,3469,3477,3499,3657,3664,3672],{"type":36,"tag":1784,"props":3424,"children":3425},{"class":1786,"line":1787},[3426,3432,3437,3442,3447,3452,3457,3461,3465],{"type":36,"tag":1784,"props":3427,"children":3429},{"style":3428},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[3430],{"type":42,"value":3431},"const",{"type":36,"tag":1784,"props":3433,"children":3434},{"style":1806},[3435],{"type":42,"value":3436}," route ",{"type":36,"tag":1784,"props":3438,"children":3439},{"style":1812},[3440],{"type":42,"value":3441},"=",{"type":36,"tag":1784,"props":3443,"children":3444},{"style":1806},[3445],{"type":42,"value":3446}," data",{"type":36,"tag":1784,"props":3448,"children":3449},{"style":1812},[3450],{"type":42,"value":3451},".",{"type":36,"tag":1784,"props":3453,"children":3454},{"style":1806},[3455],{"type":42,"value":3456},"routes[",{"type":36,"tag":1784,"props":3458,"children":3459},{"style":1954},[3460],{"type":42,"value":1957},{"type":36,"tag":1784,"props":3462,"children":3463},{"style":1806},[3464],{"type":42,"value":1962},{"type":36,"tag":1784,"props":3466,"children":3467},{"style":1812},[3468],{"type":42,"value":1865},{"type":36,"tag":1784,"props":3470,"children":3471},{"class":1786,"line":1797},[3472],{"type":36,"tag":1784,"props":3473,"children":3474},{"style":1791},[3475],{"type":42,"value":3476},"\u002F\u002F GOOD — meters \u002F seconds from the API\n",{"type":36,"tag":1784,"props":3478,"children":3479},{"class":1786,"line":1868},[3480,3485,3489,3494],{"type":36,"tag":1784,"props":3481,"children":3482},{"style":1806},[3483],{"type":42,"value":3484},"stats",{"type":36,"tag":1784,"props":3486,"children":3487},{"style":1812},[3488],{"type":42,"value":3451},{"type":36,"tag":1784,"props":3490,"children":3491},{"style":1806},[3492],{"type":42,"value":3493},"textContent ",{"type":36,"tag":1784,"props":3495,"children":3496},{"style":1812},[3497],{"type":42,"value":3498},"=\n",{"type":36,"tag":1784,"props":3500,"children":3501},{"class":1786,"line":1877},[3502,3507,3512,3517,3522,3526,3531,3536,3541,3545,3549,3554,3558,3563,3567,3571,3576,3581,3586,3591,3596,3600,3605,3609,3614,3618,3622,3627,3631,3636,3640,3644,3649,3653],{"type":36,"tag":1784,"props":3503,"children":3504},{"style":1812},[3505],{"type":42,"value":3506},"  `",{"type":36,"tag":1784,"props":3508,"children":3509},{"style":2086},[3510],{"type":42,"value":3511},"Distance ",{"type":36,"tag":1784,"props":3513,"children":3514},{"style":1812},[3515],{"type":42,"value":3516},"${",{"type":36,"tag":1784,"props":3518,"children":3519},{"style":1806},[3520],{"type":42,"value":3521},"(route",{"type":36,"tag":1784,"props":3523,"children":3524},{"style":1812},[3525],{"type":42,"value":3451},{"type":36,"tag":1784,"props":3527,"children":3528},{"style":1806},[3529],{"type":42,"value":3530},"distance ",{"type":36,"tag":1784,"props":3532,"children":3533},{"style":1812},[3534],{"type":42,"value":3535},"\u002F",{"type":36,"tag":1784,"props":3537,"children":3538},{"style":1954},[3539],{"type":42,"value":3540}," 1000",{"type":36,"tag":1784,"props":3542,"children":3543},{"style":1806},[3544],{"type":42,"value":1860},{"type":36,"tag":1784,"props":3546,"children":3547},{"style":1812},[3548],{"type":42,"value":3451},{"type":36,"tag":1784,"props":3550,"children":3551},{"style":1801},[3552],{"type":42,"value":3553},"toFixed",{"type":36,"tag":1784,"props":3555,"children":3556},{"style":1806},[3557],{"type":42,"value":1809},{"type":36,"tag":1784,"props":3559,"children":3560},{"style":1954},[3561],{"type":42,"value":3562},"2",{"type":36,"tag":1784,"props":3564,"children":3565},{"style":1806},[3566],{"type":42,"value":1860},{"type":36,"tag":1784,"props":3568,"children":3569},{"style":1812},[3570],{"type":42,"value":1855},{"type":36,"tag":1784,"props":3572,"children":3573},{"style":2086},[3574],{"type":42,"value":3575}," km · ",{"type":36,"tag":1784,"props":3577,"children":3578},{"style":1812},[3579],{"type":42,"value":3580},"`",{"type":36,"tag":1784,"props":3582,"children":3583},{"style":1812},[3584],{"type":42,"value":3585}," +",{"type":36,"tag":1784,"props":3587,"children":3588},{"style":1812},[3589],{"type":42,"value":3590}," `",{"type":36,"tag":1784,"props":3592,"children":3593},{"style":2086},[3594],{"type":42,"value":3595},"Duration ",{"type":36,"tag":1784,"props":3597,"children":3598},{"style":1812},[3599],{"type":42,"value":3516},{"type":36,"tag":1784,"props":3601,"children":3602},{"style":1806},[3603],{"type":42,"value":3604},"Math",{"type":36,"tag":1784,"props":3606,"children":3607},{"style":1812},[3608],{"type":42,"value":3451},{"type":36,"tag":1784,"props":3610,"children":3611},{"style":1801},[3612],{"type":42,"value":3613},"round",{"type":36,"tag":1784,"props":3615,"children":3616},{"style":1806},[3617],{"type":42,"value":3521},{"type":36,"tag":1784,"props":3619,"children":3620},{"style":1812},[3621],{"type":42,"value":3451},{"type":36,"tag":1784,"props":3623,"children":3624},{"style":1806},[3625],{"type":42,"value":3626},"duration ",{"type":36,"tag":1784,"props":3628,"children":3629},{"style":1812},[3630],{"type":42,"value":3535},{"type":36,"tag":1784,"props":3632,"children":3633},{"style":1954},[3634],{"type":42,"value":3635}," 60",{"type":36,"tag":1784,"props":3637,"children":3638},{"style":1806},[3639],{"type":42,"value":1860},{"type":36,"tag":1784,"props":3641,"children":3642},{"style":1812},[3643],{"type":42,"value":1855},{"type":36,"tag":1784,"props":3645,"children":3646},{"style":2086},[3647],{"type":42,"value":3648}," min",{"type":36,"tag":1784,"props":3650,"children":3651},{"style":1812},[3652],{"type":42,"value":3580},{"type":36,"tag":1784,"props":3654,"children":3655},{"style":1812},[3656],{"type":42,"value":1865},{"type":36,"tag":1784,"props":3658,"children":3659},{"class":1786,"line":1887},[3660],{"type":36,"tag":1784,"props":3661,"children":3662},{"emptyLinePlaceholder":1881},[3663],{"type":42,"value":1884},{"type":36,"tag":1784,"props":3665,"children":3666},{"class":1786,"line":1896},[3667],{"type":36,"tag":1784,"props":3668,"children":3669},{"style":1791},[3670],{"type":42,"value":3671},"\u002F\u002F BAD — cosmetic labels or hardcoded ETAs that look like a working demo\n",{"type":36,"tag":1784,"props":3673,"children":3674},{"class":1786,"line":1913},[3675],{"type":36,"tag":1784,"props":3676,"children":3677},{"style":1791},[3678],{"type":42,"value":3679},"\u002F\u002F \"Len 0.00 km · Time 2 min\" \u002F Math.round(120\u002F60)\n",{"type":36,"tag":104,"props":3681,"children":3683},{"id":3682},"isochrone-request-multiple-contours-when-the-prompt-asks-for-bands",[3684],{"type":42,"value":3685},"Isochrone — request multiple contours when the prompt asks for bands",{"type":36,"tag":1773,"props":3687,"children":3689},{"className":1775,"code":3688,"language":1777,"meta":1778,"style":1778},"\u002F\u002F GOOD — three travel-time bands\n`contours_minutes=15,30,60`;\n\n\u002F\u002F BAD — a single contour when the UX needs 15 \u002F 30 \u002F 60\n`contours_minutes=30`;\n",[3690],{"type":36,"tag":375,"props":3691,"children":3692},{"__ignoreMap":1778},[3693,3701,3721,3728,3736],{"type":36,"tag":1784,"props":3694,"children":3695},{"class":1786,"line":1787},[3696],{"type":36,"tag":1784,"props":3697,"children":3698},{"style":1791},[3699],{"type":42,"value":3700},"\u002F\u002F GOOD — three travel-time bands\n",{"type":36,"tag":1784,"props":3702,"children":3703},{"class":1786,"line":1797},[3704,3708,3713,3717],{"type":36,"tag":1784,"props":3705,"children":3706},{"style":1812},[3707],{"type":42,"value":3580},{"type":36,"tag":1784,"props":3709,"children":3710},{"style":2086},[3711],{"type":42,"value":3712},"contours_minutes=15,30,60",{"type":36,"tag":1784,"props":3714,"children":3715},{"style":1812},[3716],{"type":42,"value":3580},{"type":36,"tag":1784,"props":3718,"children":3719},{"style":1812},[3720],{"type":42,"value":1865},{"type":36,"tag":1784,"props":3722,"children":3723},{"class":1786,"line":1868},[3724],{"type":36,"tag":1784,"props":3725,"children":3726},{"emptyLinePlaceholder":1881},[3727],{"type":42,"value":1884},{"type":36,"tag":1784,"props":3729,"children":3730},{"class":1786,"line":1877},[3731],{"type":36,"tag":1784,"props":3732,"children":3733},{"style":1791},[3734],{"type":42,"value":3735},"\u002F\u002F BAD — a single contour when the UX needs 15 \u002F 30 \u002F 60\n",{"type":36,"tag":1784,"props":3737,"children":3738},{"class":1786,"line":1887},[3739,3743,3748,3752],{"type":36,"tag":1784,"props":3740,"children":3741},{"style":1812},[3742],{"type":42,"value":3580},{"type":36,"tag":1784,"props":3744,"children":3745},{"style":2086},[3746],{"type":42,"value":3747},"contours_minutes=30",{"type":36,"tag":1784,"props":3749,"children":3750},{"style":1812},[3751],{"type":42,"value":3580},{"type":36,"tag":1784,"props":3753,"children":3754},{"style":1812},[3755],{"type":42,"value":1865},{"type":36,"tag":59,"props":3757,"children":3759},{"id":3758},"integration-with-other-skills",[3760],{"type":42,"value":3761},"Integration with Other Skills",{"type":36,"tag":45,"props":3763,"children":3764},{},[3765],{"type":36,"tag":51,"props":3766,"children":3767},{},[3768],{"type":42,"value":3769},"Works with:",{"type":36,"tag":489,"props":3771,"children":3772},{},[3773,3783,3793],{"type":36,"tag":75,"props":3774,"children":3775},{},[3776,3781],{"type":36,"tag":51,"props":3777,"children":3778},{},[3779],{"type":42,"value":3780},"mapbox-search-patterns",{"type":42,"value":3782},": Search for locations, then use geospatial operations",{"type":36,"tag":75,"props":3784,"children":3785},{},[3786,3791],{"type":36,"tag":51,"props":3787,"children":3788},{},[3789],{"type":42,"value":3790},"mapbox-web-performance-patterns",{"type":42,"value":3792},": Optimize rendering of geometric calculations",{"type":36,"tag":75,"props":3794,"children":3795},{},[3796,3801],{"type":36,"tag":51,"props":3797,"children":3798},{},[3799],{"type":42,"value":3800},"mapbox-token-security",{"type":42,"value":3802},": Ensure requests use properly scoped tokens",{"type":36,"tag":59,"props":3804,"children":3806},{"id":3805},"resources",[3807],{"type":42,"value":3808},"Resources",{"type":36,"tag":489,"props":3810,"children":3811},{},[3812,3824,3836,3846,3856,3866],{"type":36,"tag":75,"props":3813,"children":3814},{},[3815],{"type":36,"tag":3816,"props":3817,"children":3821},"a",{"href":3818,"rel":3819},"https:\u002F\u002Fgithub.com\u002Fmapbox\u002Fmcp-server",[3820],"nofollow",[3822],{"type":42,"value":3823},"Mapbox MCP Server",{"type":36,"tag":75,"props":3825,"children":3826},{},[3827,3834],{"type":36,"tag":3816,"props":3828,"children":3831},{"href":3829,"rel":3830},"https:\u002F\u002Fturfjs.org\u002F",[3820],[3832],{"type":42,"value":3833},"Turf.js Documentation",{"type":42,"value":3835}," (Powers geometric tools)",{"type":36,"tag":75,"props":3837,"children":3838},{},[3839],{"type":36,"tag":3816,"props":3840,"children":3843},{"href":3841,"rel":3842},"https:\u002F\u002Fdocs.mapbox.com\u002Fapi\u002Fnavigation\u002Fdirections\u002F",[3820],[3844],{"type":42,"value":3845},"Mapbox Directions API",{"type":36,"tag":75,"props":3847,"children":3848},{},[3849],{"type":36,"tag":3816,"props":3850,"children":3853},{"href":3851,"rel":3852},"https:\u002F\u002Fdocs.mapbox.com\u002Fapi\u002Fnavigation\u002Fisochrone\u002F",[3820],[3854],{"type":42,"value":3855},"Mapbox Isochrone API",{"type":36,"tag":75,"props":3857,"children":3858},{},[3859],{"type":36,"tag":3816,"props":3860,"children":3863},{"href":3861,"rel":3862},"https:\u002F\u002Fdocs.mapbox.com\u002Fapi\u002Fnavigation\u002Fmatrix\u002F",[3820],[3864],{"type":42,"value":3865},"Mapbox Matrix API",{"type":36,"tag":75,"props":3867,"children":3868},{},[3869],{"type":36,"tag":3816,"props":3870,"children":3873},{"href":3871,"rel":3872},"https:\u002F\u002Fdocs.mapbox.com\u002Fapi\u002Fnavigation\u002Foptimization\u002F",[3820],[3874],{"type":42,"value":3875},"Mapbox Optimization API",{"type":36,"tag":3877,"props":3878,"children":3879},"style",{},[3880],{"type":42,"value":3881},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":3883,"total":4051},[3884,3898,3915,3928,3950,3956,3970,3983,3997,4010,4025,4037],{"slug":3885,"name":3885,"fn":3886,"description":3887,"org":3888,"tags":3889,"stars":20,"repoUrl":21,"updatedAt":3897},"mapbox-android-patterns","integrate Mapbox Maps SDK on Android","Official integration patterns for Mapbox Maps SDK on Android. Covers installation, adding markers, user location, custom data, styles, camera control, and featureset interactions. Based on official Mapbox documentation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3890,3893,3894],{"name":3891,"slug":3892,"type":15},"Android","android",{"name":9,"slug":8,"type":15},{"name":3895,"slug":3896,"type":15},"Mobile","mobile","2026-07-30T05:30:51.739352",{"slug":3899,"name":3899,"fn":3900,"description":3901,"org":3902,"tags":3903,"stars":20,"repoUrl":21,"updatedAt":3914},"mapbox-cartography","apply cartographic design principles to Mapbox","Expert guidance on map design principles, color theory, visual hierarchy, typography, and cartographic best practices for creating effective and beautiful maps with Mapbox. Use when designing map styles, choosing colors, or making cartographic decisions.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3904,3907,3910,3911],{"name":3905,"slug":3906,"type":15},"Branding","branding",{"name":3908,"slug":3909,"type":15},"Design","design",{"name":9,"slug":8,"type":15},{"name":3912,"slug":3913,"type":15},"Typography","typography","2026-04-06T18:28:41.2556",{"slug":3916,"name":3916,"fn":3917,"description":3918,"org":3919,"tags":3920,"stars":20,"repoUrl":21,"updatedAt":3927},"mapbox-data-visualization-patterns","implement Mapbox data visualization patterns","Patterns for visualizing data on maps including choropleth maps, heat maps, 3D visualizations, data-driven styling, and animated data. Covers layer types, color scales, and performance optimization.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3921,3924,3925,3926],{"name":3922,"slug":3923,"type":15},"Data Visualization","data-visualization",{"name":3908,"slug":3909,"type":15},{"name":9,"slug":8,"type":15},{"name":13,"slug":14,"type":15},"2026-04-06T18:29:02.907655",{"slug":3929,"name":3929,"fn":3930,"description":3931,"org":3932,"tags":3933,"stars":20,"repoUrl":21,"updatedAt":3949},"mapbox-flutter-patterns","integrate Mapbox maps into Flutter applications","Official integration patterns for the Mapbox Maps Flutter SDK. Covers installation, iOS\u002FAndroid platform setup, access token configuration, MapWidget initialization, camera control, annotations with tap handling, user location, and loading GeoJSON. Based on official Mapbox documentation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3934,3935,3938,3941,3944,3945,3946],{"name":3891,"slug":3892,"type":15},{"name":3936,"slug":3937,"type":15},"Dart","dart",{"name":3939,"slug":3940,"type":15},"Flutter","flutter",{"name":3942,"slug":3943,"type":15},"iOS","ios",{"name":9,"slug":8,"type":15},{"name":3895,"slug":3896,"type":15},{"name":3947,"slug":3948,"type":15},"SDK","sdk","2026-05-12T06:03:11.211517",{"slug":4,"name":4,"fn":5,"description":6,"org":3951,"tags":3952,"stars":20,"repoUrl":21,"updatedAt":22},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3953,3954,3955],{"name":9,"slug":8,"type":15},{"name":13,"slug":14,"type":15},{"name":18,"slug":19,"type":15},{"slug":3957,"name":3957,"fn":3958,"description":3959,"org":3960,"tags":3961,"stars":20,"repoUrl":21,"updatedAt":3969},"mapbox-google-maps-migration","migrate from Google Maps to Mapbox","Migration guide for developers moving from Google Maps Platform to Mapbox GL JS, covering API equivalents, pattern translations, and key differences",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3962,3963,3966],{"name":9,"slug":8,"type":15},{"name":3964,"slug":3965,"type":15},"Migration","migration",{"name":3967,"slug":3968,"type":15},"Web Development","web-development","2026-04-06T18:28:56.459496",{"slug":3971,"name":3971,"fn":3972,"description":3973,"org":3974,"tags":3975,"stars":20,"repoUrl":21,"updatedAt":3982},"mapbox-ios-patterns","integrate Mapbox Maps SDK on iOS","Official integration patterns for Mapbox Maps SDK on iOS. Covers installation, adding markers, user location, custom data, styles, camera control, and featureset interactions. Based on official Mapbox documentation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3976,3977,3978,3979],{"name":3942,"slug":3943,"type":15},{"name":9,"slug":8,"type":15},{"name":3895,"slug":3896,"type":15},{"name":3980,"slug":3981,"type":15},"Swift","swift","2026-07-30T05:30:54.75526",{"slug":3984,"name":3984,"fn":3985,"description":3986,"org":3987,"tags":3988,"stars":20,"repoUrl":21,"updatedAt":3996},"mapbox-location-grounding","generate grounded location-aware responses with Mapbox","Compose Mapbox MCP tools to produce grounded, cited location-aware responses from live data instead of training data",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3989,3992,3993],{"name":3990,"slug":3991,"type":15},"Data Quality","data-quality",{"name":9,"slug":8,"type":15},{"name":3994,"slug":3995,"type":15},"MCP","mcp","2026-04-15T05:01:44.248764",{"slug":3998,"name":3998,"fn":3999,"description":4000,"org":4001,"tags":4002,"stars":20,"repoUrl":21,"updatedAt":4009},"mapbox-maplibre-migration","migrate from MapLibre to Mapbox","Guide for migrating from MapLibre GL JS to Mapbox GL JS, covering API compatibility, token setup, style configuration, and the benefits of Mapbox's official support and ecosystem",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4003,4006,4007,4008],{"name":4004,"slug":4005,"type":15},"Engineering","engineering",{"name":9,"slug":8,"type":15},{"name":3964,"slug":3965,"type":15},{"name":3967,"slug":3968,"type":15},"2026-04-06T18:28:51.531856",{"slug":4011,"name":4011,"fn":4012,"description":4013,"org":4014,"tags":4015,"stars":20,"repoUrl":21,"updatedAt":4024},"mapbox-mcp-devkit-patterns","integrate Mapbox MCP DevKit in coding assistants","Integration patterns for Mapbox MCP DevKit Server in AI coding assistants. Covers setup, style management, token management, validation workflows, and documentation access through MCP. Use when building Mapbox applications with AI coding assistance.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4016,4019,4022,4023],{"name":4017,"slug":4018,"type":15},"Documentation","documentation",{"name":4020,"slug":4021,"type":15},"Local Development","local-development",{"name":9,"slug":8,"type":15},{"name":3994,"slug":3995,"type":15},"2026-04-06T18:28:53.790961",{"slug":4026,"name":4026,"fn":4027,"description":4028,"org":4029,"tags":4030,"stars":20,"repoUrl":21,"updatedAt":4036},"mapbox-mcp-runtime-patterns","integrate Mapbox MCP Server in AI apps","Integration patterns for Mapbox MCP Server in AI applications and agent frameworks. Covers runtime integration with pydantic-ai, mastra, LangChain, and custom agents. Use when building AI-powered applications that need geospatial capabilities.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4031,4034,4035],{"name":4032,"slug":4033,"type":15},"Architecture","architecture",{"name":9,"slug":8,"type":15},{"name":3994,"slug":3995,"type":15},"2026-04-06T18:28:55.164842",{"slug":4038,"name":4038,"fn":4039,"description":4040,"org":4041,"tags":4042,"stars":20,"repoUrl":21,"updatedAt":4050},"mapbox-search-integration","implement Mapbox search in applications","Complete workflow for implementing Mapbox search in applications - from discovery questions to production-ready integration with best practices",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4043,4046,4047],{"name":4044,"slug":4045,"type":15},"API Development","api-development",{"name":9,"slug":8,"type":15},{"name":4048,"slug":4049,"type":15},"Search","search","2026-04-06T18:28:50.264933",19,{"items":4053,"total":4051},[4054,4060,4067,4074,4084,4090,4096],{"slug":3885,"name":3885,"fn":3886,"description":3887,"org":4055,"tags":4056,"stars":20,"repoUrl":21,"updatedAt":3897},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4057,4058,4059],{"name":3891,"slug":3892,"type":15},{"name":9,"slug":8,"type":15},{"name":3895,"slug":3896,"type":15},{"slug":3899,"name":3899,"fn":3900,"description":3901,"org":4061,"tags":4062,"stars":20,"repoUrl":21,"updatedAt":3914},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4063,4064,4065,4066],{"name":3905,"slug":3906,"type":15},{"name":3908,"slug":3909,"type":15},{"name":9,"slug":8,"type":15},{"name":3912,"slug":3913,"type":15},{"slug":3916,"name":3916,"fn":3917,"description":3918,"org":4068,"tags":4069,"stars":20,"repoUrl":21,"updatedAt":3927},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4070,4071,4072,4073],{"name":3922,"slug":3923,"type":15},{"name":3908,"slug":3909,"type":15},{"name":9,"slug":8,"type":15},{"name":13,"slug":14,"type":15},{"slug":3929,"name":3929,"fn":3930,"description":3931,"org":4075,"tags":4076,"stars":20,"repoUrl":21,"updatedAt":3949},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4077,4078,4079,4080,4081,4082,4083],{"name":3891,"slug":3892,"type":15},{"name":3936,"slug":3937,"type":15},{"name":3939,"slug":3940,"type":15},{"name":3942,"slug":3943,"type":15},{"name":9,"slug":8,"type":15},{"name":3895,"slug":3896,"type":15},{"name":3947,"slug":3948,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":4085,"tags":4086,"stars":20,"repoUrl":21,"updatedAt":22},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4087,4088,4089],{"name":9,"slug":8,"type":15},{"name":13,"slug":14,"type":15},{"name":18,"slug":19,"type":15},{"slug":3957,"name":3957,"fn":3958,"description":3959,"org":4091,"tags":4092,"stars":20,"repoUrl":21,"updatedAt":3969},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4093,4094,4095],{"name":9,"slug":8,"type":15},{"name":3964,"slug":3965,"type":15},{"name":3967,"slug":3968,"type":15},{"slug":3971,"name":3971,"fn":3972,"description":3973,"org":4097,"tags":4098,"stars":20,"repoUrl":21,"updatedAt":3982},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[4099,4100,4101,4102],{"name":3942,"slug":3943,"type":15},{"name":9,"slug":8,"type":15},{"name":3895,"slug":3896,"type":15},{"name":3980,"slug":3981,"type":15}]