[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-mapbox-mapbox-search-patterns":3,"mdc-xfv9y3-key":30,"related-org-mapbox-mapbox-search-patterns":3759,"related-repo-mapbox-mapbox-search-patterns":3933},{"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-search-patterns","implement Mapbox search and geocoding patterns","Expert guidance on choosing the right Mapbox search tool and parameters for geocoding, POI search, and location discovery",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"mapbox","Mapbox","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fmapbox.png",[12,14,17],{"name":9,"slug":8,"type":13},"tag",{"name":15,"slug":16,"type":13},"Search","search",{"name":18,"slug":19,"type":13},"API Development","api-development",69,"https:\u002F\u002Fgithub.com\u002Fmapbox\u002Fmapbox-agent-skills","2026-07-30T05:30:56.712677",null,10,[],{"repoUrl":21,"stars":20,"forks":24,"topics":27,"description":23},[],"https:\u002F\u002Fgithub.com\u002Fmapbox\u002Fmapbox-agent-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fmapbox-search-patterns","---\nname: mapbox-search-patterns\ndescription: Expert guidance on choosing the right Mapbox search tool and parameters for geocoding, POI search, and location discovery\n---\n\n# Mapbox Search Patterns Skill\n\nExpert guidance for AI assistants on using Mapbox search tools effectively. Covers tool selection, parameter optimization, and best practices for geocoding, POI search, and location discovery.\n\n## Available Search Tools\n\n### 1. search_and_geocode_tool\n\n**Best for:** Specific places, addresses, brands, named locations\n\n**Use when query contains:**\n\n- Specific names: \"Starbucks on 5th Avenue\", \"Empire State Building\"\n- Brand names: \"McDonald's\", \"Whole Foods\"\n- Addresses: \"123 Main Street, Seattle\", \"1 Times Square\"\n- Chain stores: \"Target\"\n- Cities\u002Fplaces: \"San Francisco\", \"Portland\"\n\n**Don't use for:** Generic categories (\"coffee shops\", \"museums\")\n\n### 2. category_search_tool\n\n**Best for:** Generic place types, categories, plural queries\n\n**Use when query contains:**\n\n- Generic types: \"coffee shops\", \"restaurants\", \"gas stations\"\n- Plural forms: \"museums\", \"hotels\", \"parks\"\n- Is-a phrases: \"any coffee shop\", \"all restaurants\", \"nearby pharmacies\"\n- Industry terms: \"electric vehicle chargers\", \"ATMs\"\n\n**Don't use for:** Specific names or brands\n\n### 3. reverse_geocode_tool\n\n**Best for:** Converting coordinates to addresses, cities, towns, postcodes\n\n**Use when:**\n\n- Have GPS coordinates, need human-readable address\n- Need to identify what's at a specific location\n- Converting user location to address\n\n## Tool Selection Decision Matrix\n\n| User Query                      | Tool                    | Reasoning                |\n| ------------------------------- | ----------------------- | ------------------------ |\n| \"Find Starbucks on Main Street\" | search_and_geocode_tool | Specific brand name      |\n| \"Find coffee shops nearby\"      | category_search_tool    | Generic category, plural |\n| \"What's at 37.7749, -122.4194?\" | reverse_geocode_tool    | Coordinates to address   |\n| \"Empire State Building\"         | search_and_geocode_tool | Specific named POI       |\n| \"hotels in downtown Seattle\"    | category_search_tool    | Generic type + location  |\n| \"Target store locations\"        | search_and_geocode_tool | Brand name (even plural) |\n| \"any restaurant near me\"        | category_search_tool    | Generic + \"any\" phrase   |\n| \"123 Main St, Boston, MA\"       | search_and_geocode_tool | Specific address         |\n| \"electric vehicle chargers\"     | category_search_tool    | Industry category        |\n| \"McDonald's\"                    | search_and_geocode_tool | Brand name               |\n\n## Parameter Guidance\n\n### Proximity vs Bbox vs Country\n\n**Three ways to spatially constrain search results:**\n\n#### 1. proximity (STRONGLY RECOMMENDED)\n\n**What it does:** Biases results toward a location, but doesn't exclude distant matches\n\n**Use when:**\n\n- User says \"near me\", \"nearby\", \"close to\"\n- Have a reference point but want some flexibility\n- Want results sorted by relevance to a point\n\n**Example:**\n\n```json\n{\n  \"q\": \"pizza\",\n  \"proximity\": {\n    \"longitude\": -122.4194,\n    \"latitude\": 37.7749\n  }\n}\n```\n\n**Why this works:** API returns SF pizza places first, but might include famous NYC pizzerias if highly relevant\n\n**Critical:** Always set proximity when you have a reference location! Without it, results are IP-based or global.\n\n#### 2. bbox (Bounding Box)\n\n**What it does:** Hard constraint - ONLY returns results within the box\n\n**Use when:**\n\n- User specifies an area: \"in downtown\", \"within this neighborhood\"\n- Have a defined service area\n- Need to guarantee results are within bounds\n\n**Example:**\n\n```json\n{\n  \"q\": \"hotel\",\n  \"bbox\": [-122.51, 37.7, -122.35, 37.83] \u002F\u002F [minLon, minLat, maxLon, maxLat]\n}\n```\n\n**Why this works:** Guarantees all hotels are within SF's downtown area\n\n**Watch out:** Too small = no results; too large = irrelevant results\n\n#### 3. country\n\n**What it does:** Limits results to specific countries\n\n**Use when:**\n\n- User specifies country: \"restaurants in France\"\n- Building country-specific features\n- Need to respect regional boundaries\n- Or it is otherwise clear they want results within a specific country\n\n**Example:**\n\n```json\n{\n  \"q\": \"Paris\",\n  \"country\": [\"FR\"] \u002F\u002F ISO 3166 alpha-2 codes\n}\n```\n\n**Why this works:** Finds Paris, France (not Paris, Texas)\n\n**Can combine:** `proximity` + `country` + `bbox` or any combination of the three\n\n### Decision Matrix: Spatial Filters\n\n| Scenario                           | Use                                 | Why                               |\n| ---------------------------------- | ----------------------------------- | --------------------------------- |\n| \"Find coffee near me\"              | proximity                           | Bias toward user location         |\n| \"Coffee shops in downtown Seattle\" | proximity + bbox                    | Center on downtown, limit to area |\n| \"Hotels in France\"                 | country                             | Hard country boundary             |\n| \"Best pizza in San Francisco\"      | proximity + country [\"US\"]          | Bias to SF, limit to US           |\n| \"Gas stations along this route\"    | bbox around route                   | Hard constraint to route corridor |\n| \"Restaurants within 5 miles\"       | proximity (then filter by distance) | Bias nearby, filter results       |\n\n### Setting limit Parameter\n\n**category_search_tool only** (1-25, default 10)\n\n| Use Case              | Limit | Reasoning               |\n| --------------------- | ----- | ----------------------- |\n| Quick suggestions     | 5     | Fast, focused results   |\n| Standard list         | 10    | Default, good balance   |\n| Comprehensive search  | 25    | Maximum allowed         |\n| Map visualization     | 25    | Show all nearby options |\n| Dropdown\u002Fautocomplete | 5     | Don't overwhelm UI      |\n\n**Performance tip:** Lower limits = faster responses\n\n### types Parameter (search_and_geocode_tool)\n\n**Filter by feature type:**\n\n| Type       | What It Includes                           | Use When                          |\n| ---------- | ------------------------------------------ | --------------------------------- |\n| `poi`      | Points of interest (businesses, landmarks) | Looking for POIs, not addresses   |\n| `address`  | Street addresses                           | Need specific address             |\n| `place`    | Cities, neighborhoods, regions             | Looking for area\u002Fregion           |\n| `street`   | Street names without numbers               | Need street, not specific address |\n| `postcode` | Postal codes                               | Searching by ZIP\u002Fpostal code      |\n| `district` | Districts, neighborhoods                   | Area-based search                 |\n| `locality` | Towns, villages                            | Municipality search               |\n| `country`  | Country names                              | Country-level search              |\n\n**Example combinations:**\n\n```json\n\u002F\u002F Only POIs and addresses, no cities\n{\"q\": \"Paris\", \"types\": [\"poi\", \"address\"]}\n\u002F\u002F Returns Paris Hotel, Paris Street, not Paris, France\n\n\u002F\u002F Only places (cities)\n{\"q\": \"Paris\", \"types\": [\"place\"]}\n\u002F\u002F Returns Paris, France; Paris, Texas; etc.\n```\n\n**Default behavior:** All types included (usually what you want)\n\n### auto_complete Parameter (search_and_geocode_tool)\n\n**What it does:** Enables partial\u002Ffuzzy matching\n\n| Setting           | Behavior                     | Use When                      |\n| ----------------- | ---------------------------- | ----------------------------- |\n| `true`            | Matches partial words, typos | User typing in real-time      |\n| `false` (default) | Exact matching               | Final query, not autocomplete |\n\n**Example:**\n\n\u003C!-- cspell:disable -->\n\n```json\n\u002F\u002F User types \"starb\"\n{ \"q\": \"starb\", \"auto_complete\": true }\n\u002F\u002F Returns: Starbucks, Starboard Tavern, etc.\n```\n\n**Use for:**\n\n- Search-as-you-type interfaces\n- Handling typos (\"mcdonalds\" -> McDonald's)\n\u003C!-- cspell:enable -->\n- Incomplete queries\n\n**Don't use for:**\n\n- Final\u002Fsubmitted queries (less precise)\n- When you need exact matches\n\n## Anti-Patterns to Avoid\n\n### Don't: Use category_search for brands\n\n```javascript\n\u002F\u002F BAD\ncategory_search_tool({ category: 'starbucks' });\n\u002F\u002F \"starbucks\" is not a category, returns error\n\n\u002F\u002F GOOD\nsearch_and_geocode_tool({ q: 'Starbucks' });\n```\n\n### Don't: Use search_and_geocode for generic categories\n\n```javascript\n\u002F\u002F BAD\nsearch_and_geocode_tool({ q: 'coffee shops' });\n\u002F\u002F Less precise, may return unrelated results\n\n\u002F\u002F GOOD\ncategory_search_tool({ category: 'coffee_shop' });\n```\n\n### Don't: Forget proximity for local searches\n\n```javascript\n\u002F\u002F BAD - Results may be anywhere globally\ncategory_search_tool({ category: 'restaurant' });\n\n\u002F\u002F GOOD - Biased to user location\ncategory_search_tool({\n  category: 'restaurant',\n  proximity: { longitude: -122.4194, latitude: 37.7749 }\n});\n```\n\n### Don't: Geocode ambiguous place names without proximity (REST too)\n\nThis applies to Mapbox Geocoding API v5 \u002F Search Box in browser apps — not only MCP tools.\n\n```javascript\n\u002F\u002F BAD — limit=1 without proximity can resolve \"Lincoln Memorial\" to Illinois\nfetch(`https:\u002F\u002Fapi.mapbox.com\u002Fgeocoding\u002Fv5\u002Fmapbox.places\u002F${encodeURIComponent(q)}.json?access_token=${token}&limit=1`);\n\n\u002F\u002F GOOD — bias to map center (and optional bbox)\nfetch(\n  `https:\u002F\u002Fapi.mapbox.com\u002Fgeocoding\u002Fv5\u002Fmapbox.places\u002F${encodeURIComponent(q)}.json` +\n    `?access_token=${token}&proximity=-77.0369,38.9072&bbox=-77.15,38.79,-76.90,38.99&limit=1`\n);\n```\n\nAlso debounce search inputs (`clearTimeout` + `setTimeout`) so every keystroke does not fire a geocode.\n\n### Don't: Use bbox when you mean proximity\n\n```javascript\n\u002F\u002F BAD - Hard boundary may exclude good nearby results\nsearch_and_geocode_tool({\n  q: 'pizza',\n  bbox: [-122.42, 37.77, -122.41, 37.78] \u002F\u002F Tiny box\n});\n\n\u002F\u002F GOOD - Bias toward point, but flexible\nsearch_and_geocode_tool({\n  q: 'pizza',\n  proximity: { longitude: -122.4194, latitude: 37.7749 }\n});\n```\n\n### Don't: Request ETA unnecessarily\n\n```javascript\n\u002F\u002F BAD - Costs API quota for routing calculations\nsearch_and_geocode_tool({\n  q: 'museums',\n  eta_type: 'navigation',\n  navigation_profile: 'driving'\n});\n\u002F\u002F User didn't ask for travel time!\n\n\u002F\u002F GOOD - Only add ETA when needed\nsearch_and_geocode_tool({ q: 'museums' });\n\u002F\u002F If user asks \"how long to get there?\", then add ETA\n```\n\n### Don't: Set limit too high for UI display\n\n```javascript\n\u002F\u002F BAD - Overwhelming for simple dropdown\ncategory_search_tool({\n  category: 'restaurant',\n  limit: 25\n});\n\u002F\u002F Returns 25 restaurants for a 5-item dropdown\n\n\u002F\u002F GOOD - Match UI needs\ncategory_search_tool({\n  category: 'restaurant',\n  limit: 5\n});\n```\n\n## Quick Reference\n\n### Tool Selection Flowchart\n\n```\nUser query contains...\n\n-> Specific name\u002Fbrand (Starbucks, Empire State Building)\n  -> search_and_geocode_tool\n\n-> Generic category\u002Fplural (coffee shops, museums, any restaurant)\n  -> category_search_tool\n\n-> Coordinates -> Address\n  -> reverse_geocode_tool\n\n-> Address -> Coordinates\n  -> search_and_geocode_tool with types: [\"address\"]\n```\n\n### Essential Parameters Checklist\n\n**For local searches, ALWAYS set:**\n\n- `proximity` (or bbox if strict boundary needed)\n\n**For category searches, consider:**\n\n- `limit` (match UI needs)\n- `format` (json_string if plotting on map)\n\n**For disambiguation, use:**\n\n- `country` (when geographic context matters)\n- `types` (when feature type matters)\n\n**For travel-time ranking:**\n\n- `eta_type`, `navigation_profile`, `origin` (costs API quota)\n\n## Common Mistakes\n\n1. **Forgetting proximity** -> Results are global\u002FIP-based (or wrong state for ambiguous memorial\u002Fpark names)\n2. **Using wrong tool** -> category_search for \"Starbucks\" (use search_and_geocode)\n3. **Invalid category** -> Check category_list first\n4. **Bbox too small** -> No results; use proximity instead\n5. **Requesting ETA unnecessarily** -> Adds API cost\n6. **Limit too high for UI** -> Overwhelming user\n7. **Not filtering types** -> Get cities when you want POIs\n8. **No debounce on typeahead** -> Quota burn and racy UI\n\n## Reference Files\n\nLoad these for deeper guidance on specific topics:\n\n- **`references\u002Fadvanced-params.md`** — poi_category, ETA, format, and language parameters\n- **`references\u002Fworkflows.md`** — Common patterns: Near Me, Branded, Geocoding, Category+Area, Reverse, Route-Based, Multilingual\n- **`references\u002Foptimization-combining.md`** — Performance optimization, combining tools, handling no results, category list resource\n",{"data":31,"body":32},{"name":4,"description":6},{"type":33,"children":34},"root",[35,44,50,57,64,75,83,113,123,129,138,145,168,177,183,192,200,218,224,430,436,442,450,457,467,474,492,500,672,682,692,698,707,714,732,739,865,874,884,890,899,906,929,936,1039,1048,1078,1084,1222,1228,1238,1352,1362,1368,1376,1578,1586,1803,1813,1819,1828,1900,1907,1997,2005,2018,2026,2033,2046,2052,2058,2205,2211,2343,2349,2545,2551,2556,2762,2782,2788,3053,3059,3265,3271,3457,3463,3469,3479,3485,3493,3506,3514,3539,3547,3570,3578,3607,3613,3697,3703,3708,3753],{"type":36,"tag":37,"props":38,"children":40},"element","h1",{"id":39},"mapbox-search-patterns-skill",[41],{"type":42,"value":43},"text","Mapbox Search Patterns Skill",{"type":36,"tag":45,"props":46,"children":47},"p",{},[48],{"type":42,"value":49},"Expert guidance for AI assistants on using Mapbox search tools effectively. Covers tool selection, parameter optimization, and best practices for geocoding, POI search, and location discovery.",{"type":36,"tag":51,"props":52,"children":54},"h2",{"id":53},"available-search-tools",[55],{"type":42,"value":56},"Available Search Tools",{"type":36,"tag":58,"props":59,"children":61},"h3",{"id":60},"_1-search_and_geocode_tool",[62],{"type":42,"value":63},"1. search_and_geocode_tool",{"type":36,"tag":45,"props":65,"children":66},{},[67,73],{"type":36,"tag":68,"props":69,"children":70},"strong",{},[71],{"type":42,"value":72},"Best for:",{"type":42,"value":74}," Specific places, addresses, brands, named locations",{"type":36,"tag":45,"props":76,"children":77},{},[78],{"type":36,"tag":68,"props":79,"children":80},{},[81],{"type":42,"value":82},"Use when query contains:",{"type":36,"tag":84,"props":85,"children":86},"ul",{},[87,93,98,103,108],{"type":36,"tag":88,"props":89,"children":90},"li",{},[91],{"type":42,"value":92},"Specific names: \"Starbucks on 5th Avenue\", \"Empire State Building\"",{"type":36,"tag":88,"props":94,"children":95},{},[96],{"type":42,"value":97},"Brand names: \"McDonald's\", \"Whole Foods\"",{"type":36,"tag":88,"props":99,"children":100},{},[101],{"type":42,"value":102},"Addresses: \"123 Main Street, Seattle\", \"1 Times Square\"",{"type":36,"tag":88,"props":104,"children":105},{},[106],{"type":42,"value":107},"Chain stores: \"Target\"",{"type":36,"tag":88,"props":109,"children":110},{},[111],{"type":42,"value":112},"Cities\u002Fplaces: \"San Francisco\", \"Portland\"",{"type":36,"tag":45,"props":114,"children":115},{},[116,121],{"type":36,"tag":68,"props":117,"children":118},{},[119],{"type":42,"value":120},"Don't use for:",{"type":42,"value":122}," Generic categories (\"coffee shops\", \"museums\")",{"type":36,"tag":58,"props":124,"children":126},{"id":125},"_2-category_search_tool",[127],{"type":42,"value":128},"2. category_search_tool",{"type":36,"tag":45,"props":130,"children":131},{},[132,136],{"type":36,"tag":68,"props":133,"children":134},{},[135],{"type":42,"value":72},{"type":42,"value":137}," Generic place types, categories, plural queries",{"type":36,"tag":45,"props":139,"children":140},{},[141],{"type":36,"tag":68,"props":142,"children":143},{},[144],{"type":42,"value":82},{"type":36,"tag":84,"props":146,"children":147},{},[148,153,158,163],{"type":36,"tag":88,"props":149,"children":150},{},[151],{"type":42,"value":152},"Generic types: \"coffee shops\", \"restaurants\", \"gas stations\"",{"type":36,"tag":88,"props":154,"children":155},{},[156],{"type":42,"value":157},"Plural forms: \"museums\", \"hotels\", \"parks\"",{"type":36,"tag":88,"props":159,"children":160},{},[161],{"type":42,"value":162},"Is-a phrases: \"any coffee shop\", \"all restaurants\", \"nearby pharmacies\"",{"type":36,"tag":88,"props":164,"children":165},{},[166],{"type":42,"value":167},"Industry terms: \"electric vehicle chargers\", \"ATMs\"",{"type":36,"tag":45,"props":169,"children":170},{},[171,175],{"type":36,"tag":68,"props":172,"children":173},{},[174],{"type":42,"value":120},{"type":42,"value":176}," Specific names or brands",{"type":36,"tag":58,"props":178,"children":180},{"id":179},"_3-reverse_geocode_tool",[181],{"type":42,"value":182},"3. reverse_geocode_tool",{"type":36,"tag":45,"props":184,"children":185},{},[186,190],{"type":36,"tag":68,"props":187,"children":188},{},[189],{"type":42,"value":72},{"type":42,"value":191}," Converting coordinates to addresses, cities, towns, postcodes",{"type":36,"tag":45,"props":193,"children":194},{},[195],{"type":36,"tag":68,"props":196,"children":197},{},[198],{"type":42,"value":199},"Use when:",{"type":36,"tag":84,"props":201,"children":202},{},[203,208,213],{"type":36,"tag":88,"props":204,"children":205},{},[206],{"type":42,"value":207},"Have GPS coordinates, need human-readable address",{"type":36,"tag":88,"props":209,"children":210},{},[211],{"type":42,"value":212},"Need to identify what's at a specific location",{"type":36,"tag":88,"props":214,"children":215},{},[216],{"type":42,"value":217},"Converting user location to address",{"type":36,"tag":51,"props":219,"children":221},{"id":220},"tool-selection-decision-matrix",[222],{"type":42,"value":223},"Tool Selection Decision Matrix",{"type":36,"tag":225,"props":226,"children":227},"table",{},[228,252],{"type":36,"tag":229,"props":230,"children":231},"thead",{},[232],{"type":36,"tag":233,"props":234,"children":235},"tr",{},[236,242,247],{"type":36,"tag":237,"props":238,"children":239},"th",{},[240],{"type":42,"value":241},"User Query",{"type":36,"tag":237,"props":243,"children":244},{},[245],{"type":42,"value":246},"Tool",{"type":36,"tag":237,"props":248,"children":249},{},[250],{"type":42,"value":251},"Reasoning",{"type":36,"tag":253,"props":254,"children":255},"tbody",{},[256,275,293,311,328,345,362,379,396,413],{"type":36,"tag":233,"props":257,"children":258},{},[259,265,270],{"type":36,"tag":260,"props":261,"children":262},"td",{},[263],{"type":42,"value":264},"\"Find Starbucks on Main Street\"",{"type":36,"tag":260,"props":266,"children":267},{},[268],{"type":42,"value":269},"search_and_geocode_tool",{"type":36,"tag":260,"props":271,"children":272},{},[273],{"type":42,"value":274},"Specific brand name",{"type":36,"tag":233,"props":276,"children":277},{},[278,283,288],{"type":36,"tag":260,"props":279,"children":280},{},[281],{"type":42,"value":282},"\"Find coffee shops nearby\"",{"type":36,"tag":260,"props":284,"children":285},{},[286],{"type":42,"value":287},"category_search_tool",{"type":36,"tag":260,"props":289,"children":290},{},[291],{"type":42,"value":292},"Generic category, plural",{"type":36,"tag":233,"props":294,"children":295},{},[296,301,306],{"type":36,"tag":260,"props":297,"children":298},{},[299],{"type":42,"value":300},"\"What's at 37.7749, -122.4194?\"",{"type":36,"tag":260,"props":302,"children":303},{},[304],{"type":42,"value":305},"reverse_geocode_tool",{"type":36,"tag":260,"props":307,"children":308},{},[309],{"type":42,"value":310},"Coordinates to address",{"type":36,"tag":233,"props":312,"children":313},{},[314,319,323],{"type":36,"tag":260,"props":315,"children":316},{},[317],{"type":42,"value":318},"\"Empire State Building\"",{"type":36,"tag":260,"props":320,"children":321},{},[322],{"type":42,"value":269},{"type":36,"tag":260,"props":324,"children":325},{},[326],{"type":42,"value":327},"Specific named POI",{"type":36,"tag":233,"props":329,"children":330},{},[331,336,340],{"type":36,"tag":260,"props":332,"children":333},{},[334],{"type":42,"value":335},"\"hotels in downtown Seattle\"",{"type":36,"tag":260,"props":337,"children":338},{},[339],{"type":42,"value":287},{"type":36,"tag":260,"props":341,"children":342},{},[343],{"type":42,"value":344},"Generic type + location",{"type":36,"tag":233,"props":346,"children":347},{},[348,353,357],{"type":36,"tag":260,"props":349,"children":350},{},[351],{"type":42,"value":352},"\"Target store locations\"",{"type":36,"tag":260,"props":354,"children":355},{},[356],{"type":42,"value":269},{"type":36,"tag":260,"props":358,"children":359},{},[360],{"type":42,"value":361},"Brand name (even plural)",{"type":36,"tag":233,"props":363,"children":364},{},[365,370,374],{"type":36,"tag":260,"props":366,"children":367},{},[368],{"type":42,"value":369},"\"any restaurant near me\"",{"type":36,"tag":260,"props":371,"children":372},{},[373],{"type":42,"value":287},{"type":36,"tag":260,"props":375,"children":376},{},[377],{"type":42,"value":378},"Generic + \"any\" phrase",{"type":36,"tag":233,"props":380,"children":381},{},[382,387,391],{"type":36,"tag":260,"props":383,"children":384},{},[385],{"type":42,"value":386},"\"123 Main St, Boston, MA\"",{"type":36,"tag":260,"props":388,"children":389},{},[390],{"type":42,"value":269},{"type":36,"tag":260,"props":392,"children":393},{},[394],{"type":42,"value":395},"Specific address",{"type":36,"tag":233,"props":397,"children":398},{},[399,404,408],{"type":36,"tag":260,"props":400,"children":401},{},[402],{"type":42,"value":403},"\"electric vehicle chargers\"",{"type":36,"tag":260,"props":405,"children":406},{},[407],{"type":42,"value":287},{"type":36,"tag":260,"props":409,"children":410},{},[411],{"type":42,"value":412},"Industry category",{"type":36,"tag":233,"props":414,"children":415},{},[416,421,425],{"type":36,"tag":260,"props":417,"children":418},{},[419],{"type":42,"value":420},"\"McDonald's\"",{"type":36,"tag":260,"props":422,"children":423},{},[424],{"type":42,"value":269},{"type":36,"tag":260,"props":426,"children":427},{},[428],{"type":42,"value":429},"Brand name",{"type":36,"tag":51,"props":431,"children":433},{"id":432},"parameter-guidance",[434],{"type":42,"value":435},"Parameter Guidance",{"type":36,"tag":58,"props":437,"children":439},{"id":438},"proximity-vs-bbox-vs-country",[440],{"type":42,"value":441},"Proximity vs Bbox vs Country",{"type":36,"tag":45,"props":443,"children":444},{},[445],{"type":36,"tag":68,"props":446,"children":447},{},[448],{"type":42,"value":449},"Three ways to spatially constrain search results:",{"type":36,"tag":451,"props":452,"children":454},"h4",{"id":453},"_1-proximity-strongly-recommended",[455],{"type":42,"value":456},"1. proximity (STRONGLY RECOMMENDED)",{"type":36,"tag":45,"props":458,"children":459},{},[460,465],{"type":36,"tag":68,"props":461,"children":462},{},[463],{"type":42,"value":464},"What it does:",{"type":42,"value":466}," Biases results toward a location, but doesn't exclude distant matches",{"type":36,"tag":45,"props":468,"children":469},{},[470],{"type":36,"tag":68,"props":471,"children":472},{},[473],{"type":42,"value":199},{"type":36,"tag":84,"props":475,"children":476},{},[477,482,487],{"type":36,"tag":88,"props":478,"children":479},{},[480],{"type":42,"value":481},"User says \"near me\", \"nearby\", \"close to\"",{"type":36,"tag":88,"props":483,"children":484},{},[485],{"type":42,"value":486},"Have a reference point but want some flexibility",{"type":36,"tag":88,"props":488,"children":489},{},[490],{"type":42,"value":491},"Want results sorted by relevance to a point",{"type":36,"tag":45,"props":493,"children":494},{},[495],{"type":36,"tag":68,"props":496,"children":497},{},[498],{"type":42,"value":499},"Example:",{"type":36,"tag":501,"props":502,"children":507},"pre",{"className":503,"code":504,"language":505,"meta":506,"style":506},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"q\": \"pizza\",\n  \"proximity\": {\n    \"longitude\": -122.4194,\n    \"latitude\": 37.7749\n  }\n}\n","json","",[508],{"type":36,"tag":509,"props":510,"children":511},"code",{"__ignoreMap":506},[512,524,569,595,628,654,663],{"type":36,"tag":513,"props":514,"children":517},"span",{"class":515,"line":516},"line",1,[518],{"type":36,"tag":513,"props":519,"children":521},{"style":520},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[522],{"type":42,"value":523},"{\n",{"type":36,"tag":513,"props":525,"children":527},{"class":515,"line":526},2,[528,533,539,544,549,554,560,564],{"type":36,"tag":513,"props":529,"children":530},{"style":520},[531],{"type":42,"value":532},"  \"",{"type":36,"tag":513,"props":534,"children":536},{"style":535},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[537],{"type":42,"value":538},"q",{"type":36,"tag":513,"props":540,"children":541},{"style":520},[542],{"type":42,"value":543},"\"",{"type":36,"tag":513,"props":545,"children":546},{"style":520},[547],{"type":42,"value":548},":",{"type":36,"tag":513,"props":550,"children":551},{"style":520},[552],{"type":42,"value":553}," \"",{"type":36,"tag":513,"props":555,"children":557},{"style":556},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[558],{"type":42,"value":559},"pizza",{"type":36,"tag":513,"props":561,"children":562},{"style":520},[563],{"type":42,"value":543},{"type":36,"tag":513,"props":565,"children":566},{"style":520},[567],{"type":42,"value":568},",\n",{"type":36,"tag":513,"props":570,"children":572},{"class":515,"line":571},3,[573,577,582,586,590],{"type":36,"tag":513,"props":574,"children":575},{"style":520},[576],{"type":42,"value":532},{"type":36,"tag":513,"props":578,"children":579},{"style":535},[580],{"type":42,"value":581},"proximity",{"type":36,"tag":513,"props":583,"children":584},{"style":520},[585],{"type":42,"value":543},{"type":36,"tag":513,"props":587,"children":588},{"style":520},[589],{"type":42,"value":548},{"type":36,"tag":513,"props":591,"children":592},{"style":520},[593],{"type":42,"value":594}," {\n",{"type":36,"tag":513,"props":596,"children":598},{"class":515,"line":597},4,[599,604,610,614,618,624],{"type":36,"tag":513,"props":600,"children":601},{"style":520},[602],{"type":42,"value":603},"    \"",{"type":36,"tag":513,"props":605,"children":607},{"style":606},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[608],{"type":42,"value":609},"longitude",{"type":36,"tag":513,"props":611,"children":612},{"style":520},[613],{"type":42,"value":543},{"type":36,"tag":513,"props":615,"children":616},{"style":520},[617],{"type":42,"value":548},{"type":36,"tag":513,"props":619,"children":621},{"style":620},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[622],{"type":42,"value":623}," -122.4194",{"type":36,"tag":513,"props":625,"children":626},{"style":520},[627],{"type":42,"value":568},{"type":36,"tag":513,"props":629,"children":631},{"class":515,"line":630},5,[632,636,641,645,649],{"type":36,"tag":513,"props":633,"children":634},{"style":520},[635],{"type":42,"value":603},{"type":36,"tag":513,"props":637,"children":638},{"style":606},[639],{"type":42,"value":640},"latitude",{"type":36,"tag":513,"props":642,"children":643},{"style":520},[644],{"type":42,"value":543},{"type":36,"tag":513,"props":646,"children":647},{"style":520},[648],{"type":42,"value":548},{"type":36,"tag":513,"props":650,"children":651},{"style":620},[652],{"type":42,"value":653}," 37.7749\n",{"type":36,"tag":513,"props":655,"children":657},{"class":515,"line":656},6,[658],{"type":36,"tag":513,"props":659,"children":660},{"style":520},[661],{"type":42,"value":662},"  }\n",{"type":36,"tag":513,"props":664,"children":666},{"class":515,"line":665},7,[667],{"type":36,"tag":513,"props":668,"children":669},{"style":520},[670],{"type":42,"value":671},"}\n",{"type":36,"tag":45,"props":673,"children":674},{},[675,680],{"type":36,"tag":68,"props":676,"children":677},{},[678],{"type":42,"value":679},"Why this works:",{"type":42,"value":681}," API returns SF pizza places first, but might include famous NYC pizzerias if highly relevant",{"type":36,"tag":45,"props":683,"children":684},{},[685,690],{"type":36,"tag":68,"props":686,"children":687},{},[688],{"type":42,"value":689},"Critical:",{"type":42,"value":691}," Always set proximity when you have a reference location! Without it, results are IP-based or global.",{"type":36,"tag":451,"props":693,"children":695},{"id":694},"_2-bbox-bounding-box",[696],{"type":42,"value":697},"2. bbox (Bounding Box)",{"type":36,"tag":45,"props":699,"children":700},{},[701,705],{"type":36,"tag":68,"props":702,"children":703},{},[704],{"type":42,"value":464},{"type":42,"value":706}," Hard constraint - ONLY returns results within the box",{"type":36,"tag":45,"props":708,"children":709},{},[710],{"type":36,"tag":68,"props":711,"children":712},{},[713],{"type":42,"value":199},{"type":36,"tag":84,"props":715,"children":716},{},[717,722,727],{"type":36,"tag":88,"props":718,"children":719},{},[720],{"type":42,"value":721},"User specifies an area: \"in downtown\", \"within this neighborhood\"",{"type":36,"tag":88,"props":723,"children":724},{},[725],{"type":42,"value":726},"Have a defined service area",{"type":36,"tag":88,"props":728,"children":729},{},[730],{"type":42,"value":731},"Need to guarantee results are within bounds",{"type":36,"tag":45,"props":733,"children":734},{},[735],{"type":36,"tag":68,"props":736,"children":737},{},[738],{"type":42,"value":499},{"type":36,"tag":501,"props":740,"children":742},{"className":503,"code":741,"language":505,"meta":506,"style":506},"{\n  \"q\": \"hotel\",\n  \"bbox\": [-122.51, 37.7, -122.35, 37.83] \u002F\u002F [minLon, minLat, maxLon, maxLat]\n}\n",[743],{"type":36,"tag":509,"props":744,"children":745},{"__ignoreMap":506},[746,753,789,858],{"type":36,"tag":513,"props":747,"children":748},{"class":515,"line":516},[749],{"type":36,"tag":513,"props":750,"children":751},{"style":520},[752],{"type":42,"value":523},{"type":36,"tag":513,"props":754,"children":755},{"class":515,"line":526},[756,760,764,768,772,776,781,785],{"type":36,"tag":513,"props":757,"children":758},{"style":520},[759],{"type":42,"value":532},{"type":36,"tag":513,"props":761,"children":762},{"style":535},[763],{"type":42,"value":538},{"type":36,"tag":513,"props":765,"children":766},{"style":520},[767],{"type":42,"value":543},{"type":36,"tag":513,"props":769,"children":770},{"style":520},[771],{"type":42,"value":548},{"type":36,"tag":513,"props":773,"children":774},{"style":520},[775],{"type":42,"value":553},{"type":36,"tag":513,"props":777,"children":778},{"style":556},[779],{"type":42,"value":780},"hotel",{"type":36,"tag":513,"props":782,"children":783},{"style":520},[784],{"type":42,"value":543},{"type":36,"tag":513,"props":786,"children":787},{"style":520},[788],{"type":42,"value":568},{"type":36,"tag":513,"props":790,"children":791},{"class":515,"line":571},[792,796,801,805,809,814,819,824,829,833,838,842,847,852],{"type":36,"tag":513,"props":793,"children":794},{"style":520},[795],{"type":42,"value":532},{"type":36,"tag":513,"props":797,"children":798},{"style":535},[799],{"type":42,"value":800},"bbox",{"type":36,"tag":513,"props":802,"children":803},{"style":520},[804],{"type":42,"value":543},{"type":36,"tag":513,"props":806,"children":807},{"style":520},[808],{"type":42,"value":548},{"type":36,"tag":513,"props":810,"children":811},{"style":520},[812],{"type":42,"value":813}," [",{"type":36,"tag":513,"props":815,"children":816},{"style":620},[817],{"type":42,"value":818},"-122.51",{"type":36,"tag":513,"props":820,"children":821},{"style":520},[822],{"type":42,"value":823},",",{"type":36,"tag":513,"props":825,"children":826},{"style":620},[827],{"type":42,"value":828}," 37.7",{"type":36,"tag":513,"props":830,"children":831},{"style":520},[832],{"type":42,"value":823},{"type":36,"tag":513,"props":834,"children":835},{"style":620},[836],{"type":42,"value":837}," -122.35",{"type":36,"tag":513,"props":839,"children":840},{"style":520},[841],{"type":42,"value":823},{"type":36,"tag":513,"props":843,"children":844},{"style":620},[845],{"type":42,"value":846}," 37.83",{"type":36,"tag":513,"props":848,"children":849},{"style":520},[850],{"type":42,"value":851},"]",{"type":36,"tag":513,"props":853,"children":855},{"style":854},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[856],{"type":42,"value":857}," \u002F\u002F [minLon, minLat, maxLon, maxLat]\n",{"type":36,"tag":513,"props":859,"children":860},{"class":515,"line":597},[861],{"type":36,"tag":513,"props":862,"children":863},{"style":520},[864],{"type":42,"value":671},{"type":36,"tag":45,"props":866,"children":867},{},[868,872],{"type":36,"tag":68,"props":869,"children":870},{},[871],{"type":42,"value":679},{"type":42,"value":873}," Guarantees all hotels are within SF's downtown area",{"type":36,"tag":45,"props":875,"children":876},{},[877,882],{"type":36,"tag":68,"props":878,"children":879},{},[880],{"type":42,"value":881},"Watch out:",{"type":42,"value":883}," Too small = no results; too large = irrelevant results",{"type":36,"tag":451,"props":885,"children":887},{"id":886},"_3-country",[888],{"type":42,"value":889},"3. country",{"type":36,"tag":45,"props":891,"children":892},{},[893,897],{"type":36,"tag":68,"props":894,"children":895},{},[896],{"type":42,"value":464},{"type":42,"value":898}," Limits results to specific countries",{"type":36,"tag":45,"props":900,"children":901},{},[902],{"type":36,"tag":68,"props":903,"children":904},{},[905],{"type":42,"value":199},{"type":36,"tag":84,"props":907,"children":908},{},[909,914,919,924],{"type":36,"tag":88,"props":910,"children":911},{},[912],{"type":42,"value":913},"User specifies country: \"restaurants in France\"",{"type":36,"tag":88,"props":915,"children":916},{},[917],{"type":42,"value":918},"Building country-specific features",{"type":36,"tag":88,"props":920,"children":921},{},[922],{"type":42,"value":923},"Need to respect regional boundaries",{"type":36,"tag":88,"props":925,"children":926},{},[927],{"type":42,"value":928},"Or it is otherwise clear they want results within a specific country",{"type":36,"tag":45,"props":930,"children":931},{},[932],{"type":36,"tag":68,"props":933,"children":934},{},[935],{"type":42,"value":499},{"type":36,"tag":501,"props":937,"children":939},{"className":503,"code":938,"language":505,"meta":506,"style":506},"{\n  \"q\": \"Paris\",\n  \"country\": [\"FR\"] \u002F\u002F ISO 3166 alpha-2 codes\n}\n",[940],{"type":36,"tag":509,"props":941,"children":942},{"__ignoreMap":506},[943,950,986,1032],{"type":36,"tag":513,"props":944,"children":945},{"class":515,"line":516},[946],{"type":36,"tag":513,"props":947,"children":948},{"style":520},[949],{"type":42,"value":523},{"type":36,"tag":513,"props":951,"children":952},{"class":515,"line":526},[953,957,961,965,969,973,978,982],{"type":36,"tag":513,"props":954,"children":955},{"style":520},[956],{"type":42,"value":532},{"type":36,"tag":513,"props":958,"children":959},{"style":535},[960],{"type":42,"value":538},{"type":36,"tag":513,"props":962,"children":963},{"style":520},[964],{"type":42,"value":543},{"type":36,"tag":513,"props":966,"children":967},{"style":520},[968],{"type":42,"value":548},{"type":36,"tag":513,"props":970,"children":971},{"style":520},[972],{"type":42,"value":553},{"type":36,"tag":513,"props":974,"children":975},{"style":556},[976],{"type":42,"value":977},"Paris",{"type":36,"tag":513,"props":979,"children":980},{"style":520},[981],{"type":42,"value":543},{"type":36,"tag":513,"props":983,"children":984},{"style":520},[985],{"type":42,"value":568},{"type":36,"tag":513,"props":987,"children":988},{"class":515,"line":571},[989,993,998,1002,1006,1010,1014,1019,1023,1027],{"type":36,"tag":513,"props":990,"children":991},{"style":520},[992],{"type":42,"value":532},{"type":36,"tag":513,"props":994,"children":995},{"style":535},[996],{"type":42,"value":997},"country",{"type":36,"tag":513,"props":999,"children":1000},{"style":520},[1001],{"type":42,"value":543},{"type":36,"tag":513,"props":1003,"children":1004},{"style":520},[1005],{"type":42,"value":548},{"type":36,"tag":513,"props":1007,"children":1008},{"style":520},[1009],{"type":42,"value":813},{"type":36,"tag":513,"props":1011,"children":1012},{"style":520},[1013],{"type":42,"value":543},{"type":36,"tag":513,"props":1015,"children":1016},{"style":556},[1017],{"type":42,"value":1018},"FR",{"type":36,"tag":513,"props":1020,"children":1021},{"style":520},[1022],{"type":42,"value":543},{"type":36,"tag":513,"props":1024,"children":1025},{"style":520},[1026],{"type":42,"value":851},{"type":36,"tag":513,"props":1028,"children":1029},{"style":854},[1030],{"type":42,"value":1031}," \u002F\u002F ISO 3166 alpha-2 codes\n",{"type":36,"tag":513,"props":1033,"children":1034},{"class":515,"line":597},[1035],{"type":36,"tag":513,"props":1036,"children":1037},{"style":520},[1038],{"type":42,"value":671},{"type":36,"tag":45,"props":1040,"children":1041},{},[1042,1046],{"type":36,"tag":68,"props":1043,"children":1044},{},[1045],{"type":42,"value":679},{"type":42,"value":1047}," Finds Paris, France (not Paris, Texas)",{"type":36,"tag":45,"props":1049,"children":1050},{},[1051,1056,1058,1063,1065,1070,1071,1076],{"type":36,"tag":68,"props":1052,"children":1053},{},[1054],{"type":42,"value":1055},"Can combine:",{"type":42,"value":1057}," ",{"type":36,"tag":509,"props":1059,"children":1061},{"className":1060},[],[1062],{"type":42,"value":581},{"type":42,"value":1064}," + ",{"type":36,"tag":509,"props":1066,"children":1068},{"className":1067},[],[1069],{"type":42,"value":997},{"type":42,"value":1064},{"type":36,"tag":509,"props":1072,"children":1074},{"className":1073},[],[1075],{"type":42,"value":800},{"type":42,"value":1077}," or any combination of the three",{"type":36,"tag":58,"props":1079,"children":1081},{"id":1080},"decision-matrix-spatial-filters",[1082],{"type":42,"value":1083},"Decision Matrix: Spatial Filters",{"type":36,"tag":225,"props":1085,"children":1086},{},[1087,1108],{"type":36,"tag":229,"props":1088,"children":1089},{},[1090],{"type":36,"tag":233,"props":1091,"children":1092},{},[1093,1098,1103],{"type":36,"tag":237,"props":1094,"children":1095},{},[1096],{"type":42,"value":1097},"Scenario",{"type":36,"tag":237,"props":1099,"children":1100},{},[1101],{"type":42,"value":1102},"Use",{"type":36,"tag":237,"props":1104,"children":1105},{},[1106],{"type":42,"value":1107},"Why",{"type":36,"tag":253,"props":1109,"children":1110},{},[1111,1128,1146,1163,1186,1204],{"type":36,"tag":233,"props":1112,"children":1113},{},[1114,1119,1123],{"type":36,"tag":260,"props":1115,"children":1116},{},[1117],{"type":42,"value":1118},"\"Find coffee near me\"",{"type":36,"tag":260,"props":1120,"children":1121},{},[1122],{"type":42,"value":581},{"type":36,"tag":260,"props":1124,"children":1125},{},[1126],{"type":42,"value":1127},"Bias toward user location",{"type":36,"tag":233,"props":1129,"children":1130},{},[1131,1136,1141],{"type":36,"tag":260,"props":1132,"children":1133},{},[1134],{"type":42,"value":1135},"\"Coffee shops in downtown Seattle\"",{"type":36,"tag":260,"props":1137,"children":1138},{},[1139],{"type":42,"value":1140},"proximity + bbox",{"type":36,"tag":260,"props":1142,"children":1143},{},[1144],{"type":42,"value":1145},"Center on downtown, limit to area",{"type":36,"tag":233,"props":1147,"children":1148},{},[1149,1154,1158],{"type":36,"tag":260,"props":1150,"children":1151},{},[1152],{"type":42,"value":1153},"\"Hotels in France\"",{"type":36,"tag":260,"props":1155,"children":1156},{},[1157],{"type":42,"value":997},{"type":36,"tag":260,"props":1159,"children":1160},{},[1161],{"type":42,"value":1162},"Hard country boundary",{"type":36,"tag":233,"props":1164,"children":1165},{},[1166,1171,1181],{"type":36,"tag":260,"props":1167,"children":1168},{},[1169],{"type":42,"value":1170},"\"Best pizza in San Francisco\"",{"type":36,"tag":260,"props":1172,"children":1173},{},[1174,1176],{"type":42,"value":1175},"proximity + country ",{"type":36,"tag":513,"props":1177,"children":1178},{},[1179],{"type":42,"value":1180},"\"US\"",{"type":36,"tag":260,"props":1182,"children":1183},{},[1184],{"type":42,"value":1185},"Bias to SF, limit to US",{"type":36,"tag":233,"props":1187,"children":1188},{},[1189,1194,1199],{"type":36,"tag":260,"props":1190,"children":1191},{},[1192],{"type":42,"value":1193},"\"Gas stations along this route\"",{"type":36,"tag":260,"props":1195,"children":1196},{},[1197],{"type":42,"value":1198},"bbox around route",{"type":36,"tag":260,"props":1200,"children":1201},{},[1202],{"type":42,"value":1203},"Hard constraint to route corridor",{"type":36,"tag":233,"props":1205,"children":1206},{},[1207,1212,1217],{"type":36,"tag":260,"props":1208,"children":1209},{},[1210],{"type":42,"value":1211},"\"Restaurants within 5 miles\"",{"type":36,"tag":260,"props":1213,"children":1214},{},[1215],{"type":42,"value":1216},"proximity (then filter by distance)",{"type":36,"tag":260,"props":1218,"children":1219},{},[1220],{"type":42,"value":1221},"Bias nearby, filter results",{"type":36,"tag":58,"props":1223,"children":1225},{"id":1224},"setting-limit-parameter",[1226],{"type":42,"value":1227},"Setting limit Parameter",{"type":36,"tag":45,"props":1229,"children":1230},{},[1231,1236],{"type":36,"tag":68,"props":1232,"children":1233},{},[1234],{"type":42,"value":1235},"category_search_tool only",{"type":42,"value":1237}," (1-25, default 10)",{"type":36,"tag":225,"props":1239,"children":1240},{},[1241,1261],{"type":36,"tag":229,"props":1242,"children":1243},{},[1244],{"type":36,"tag":233,"props":1245,"children":1246},{},[1247,1252,1257],{"type":36,"tag":237,"props":1248,"children":1249},{},[1250],{"type":42,"value":1251},"Use Case",{"type":36,"tag":237,"props":1253,"children":1254},{},[1255],{"type":42,"value":1256},"Limit",{"type":36,"tag":237,"props":1258,"children":1259},{},[1260],{"type":42,"value":251},{"type":36,"tag":253,"props":1262,"children":1263},{},[1264,1282,1300,1318,1335],{"type":36,"tag":233,"props":1265,"children":1266},{},[1267,1272,1277],{"type":36,"tag":260,"props":1268,"children":1269},{},[1270],{"type":42,"value":1271},"Quick suggestions",{"type":36,"tag":260,"props":1273,"children":1274},{},[1275],{"type":42,"value":1276},"5",{"type":36,"tag":260,"props":1278,"children":1279},{},[1280],{"type":42,"value":1281},"Fast, focused results",{"type":36,"tag":233,"props":1283,"children":1284},{},[1285,1290,1295],{"type":36,"tag":260,"props":1286,"children":1287},{},[1288],{"type":42,"value":1289},"Standard list",{"type":36,"tag":260,"props":1291,"children":1292},{},[1293],{"type":42,"value":1294},"10",{"type":36,"tag":260,"props":1296,"children":1297},{},[1298],{"type":42,"value":1299},"Default, good balance",{"type":36,"tag":233,"props":1301,"children":1302},{},[1303,1308,1313],{"type":36,"tag":260,"props":1304,"children":1305},{},[1306],{"type":42,"value":1307},"Comprehensive search",{"type":36,"tag":260,"props":1309,"children":1310},{},[1311],{"type":42,"value":1312},"25",{"type":36,"tag":260,"props":1314,"children":1315},{},[1316],{"type":42,"value":1317},"Maximum allowed",{"type":36,"tag":233,"props":1319,"children":1320},{},[1321,1326,1330],{"type":36,"tag":260,"props":1322,"children":1323},{},[1324],{"type":42,"value":1325},"Map visualization",{"type":36,"tag":260,"props":1327,"children":1328},{},[1329],{"type":42,"value":1312},{"type":36,"tag":260,"props":1331,"children":1332},{},[1333],{"type":42,"value":1334},"Show all nearby options",{"type":36,"tag":233,"props":1336,"children":1337},{},[1338,1343,1347],{"type":36,"tag":260,"props":1339,"children":1340},{},[1341],{"type":42,"value":1342},"Dropdown\u002Fautocomplete",{"type":36,"tag":260,"props":1344,"children":1345},{},[1346],{"type":42,"value":1276},{"type":36,"tag":260,"props":1348,"children":1349},{},[1350],{"type":42,"value":1351},"Don't overwhelm UI",{"type":36,"tag":45,"props":1353,"children":1354},{},[1355,1360],{"type":36,"tag":68,"props":1356,"children":1357},{},[1358],{"type":42,"value":1359},"Performance tip:",{"type":42,"value":1361}," Lower limits = faster responses",{"type":36,"tag":58,"props":1363,"children":1365},{"id":1364},"types-parameter-search_and_geocode_tool",[1366],{"type":42,"value":1367},"types Parameter (search_and_geocode_tool)",{"type":36,"tag":45,"props":1369,"children":1370},{},[1371],{"type":36,"tag":68,"props":1372,"children":1373},{},[1374],{"type":42,"value":1375},"Filter by feature type:",{"type":36,"tag":225,"props":1377,"children":1378},{},[1379,1400],{"type":36,"tag":229,"props":1380,"children":1381},{},[1382],{"type":36,"tag":233,"props":1383,"children":1384},{},[1385,1390,1395],{"type":36,"tag":237,"props":1386,"children":1387},{},[1388],{"type":42,"value":1389},"Type",{"type":36,"tag":237,"props":1391,"children":1392},{},[1393],{"type":42,"value":1394},"What It Includes",{"type":36,"tag":237,"props":1396,"children":1397},{},[1398],{"type":42,"value":1399},"Use When",{"type":36,"tag":253,"props":1401,"children":1402},{},[1403,1425,1447,1469,1491,1513,1535,1557],{"type":36,"tag":233,"props":1404,"children":1405},{},[1406,1415,1420],{"type":36,"tag":260,"props":1407,"children":1408},{},[1409],{"type":36,"tag":509,"props":1410,"children":1412},{"className":1411},[],[1413],{"type":42,"value":1414},"poi",{"type":36,"tag":260,"props":1416,"children":1417},{},[1418],{"type":42,"value":1419},"Points of interest (businesses, landmarks)",{"type":36,"tag":260,"props":1421,"children":1422},{},[1423],{"type":42,"value":1424},"Looking for POIs, not addresses",{"type":36,"tag":233,"props":1426,"children":1427},{},[1428,1437,1442],{"type":36,"tag":260,"props":1429,"children":1430},{},[1431],{"type":36,"tag":509,"props":1432,"children":1434},{"className":1433},[],[1435],{"type":42,"value":1436},"address",{"type":36,"tag":260,"props":1438,"children":1439},{},[1440],{"type":42,"value":1441},"Street addresses",{"type":36,"tag":260,"props":1443,"children":1444},{},[1445],{"type":42,"value":1446},"Need specific address",{"type":36,"tag":233,"props":1448,"children":1449},{},[1450,1459,1464],{"type":36,"tag":260,"props":1451,"children":1452},{},[1453],{"type":36,"tag":509,"props":1454,"children":1456},{"className":1455},[],[1457],{"type":42,"value":1458},"place",{"type":36,"tag":260,"props":1460,"children":1461},{},[1462],{"type":42,"value":1463},"Cities, neighborhoods, regions",{"type":36,"tag":260,"props":1465,"children":1466},{},[1467],{"type":42,"value":1468},"Looking for area\u002Fregion",{"type":36,"tag":233,"props":1470,"children":1471},{},[1472,1481,1486],{"type":36,"tag":260,"props":1473,"children":1474},{},[1475],{"type":36,"tag":509,"props":1476,"children":1478},{"className":1477},[],[1479],{"type":42,"value":1480},"street",{"type":36,"tag":260,"props":1482,"children":1483},{},[1484],{"type":42,"value":1485},"Street names without numbers",{"type":36,"tag":260,"props":1487,"children":1488},{},[1489],{"type":42,"value":1490},"Need street, not specific address",{"type":36,"tag":233,"props":1492,"children":1493},{},[1494,1503,1508],{"type":36,"tag":260,"props":1495,"children":1496},{},[1497],{"type":36,"tag":509,"props":1498,"children":1500},{"className":1499},[],[1501],{"type":42,"value":1502},"postcode",{"type":36,"tag":260,"props":1504,"children":1505},{},[1506],{"type":42,"value":1507},"Postal codes",{"type":36,"tag":260,"props":1509,"children":1510},{},[1511],{"type":42,"value":1512},"Searching by ZIP\u002Fpostal code",{"type":36,"tag":233,"props":1514,"children":1515},{},[1516,1525,1530],{"type":36,"tag":260,"props":1517,"children":1518},{},[1519],{"type":36,"tag":509,"props":1520,"children":1522},{"className":1521},[],[1523],{"type":42,"value":1524},"district",{"type":36,"tag":260,"props":1526,"children":1527},{},[1528],{"type":42,"value":1529},"Districts, neighborhoods",{"type":36,"tag":260,"props":1531,"children":1532},{},[1533],{"type":42,"value":1534},"Area-based search",{"type":36,"tag":233,"props":1536,"children":1537},{},[1538,1547,1552],{"type":36,"tag":260,"props":1539,"children":1540},{},[1541],{"type":36,"tag":509,"props":1542,"children":1544},{"className":1543},[],[1545],{"type":42,"value":1546},"locality",{"type":36,"tag":260,"props":1548,"children":1549},{},[1550],{"type":42,"value":1551},"Towns, villages",{"type":36,"tag":260,"props":1553,"children":1554},{},[1555],{"type":42,"value":1556},"Municipality search",{"type":36,"tag":233,"props":1558,"children":1559},{},[1560,1568,1573],{"type":36,"tag":260,"props":1561,"children":1562},{},[1563],{"type":36,"tag":509,"props":1564,"children":1566},{"className":1565},[],[1567],{"type":42,"value":997},{"type":36,"tag":260,"props":1569,"children":1570},{},[1571],{"type":42,"value":1572},"Country names",{"type":36,"tag":260,"props":1574,"children":1575},{},[1576],{"type":42,"value":1577},"Country-level search",{"type":36,"tag":45,"props":1579,"children":1580},{},[1581],{"type":36,"tag":68,"props":1582,"children":1583},{},[1584],{"type":42,"value":1585},"Example combinations:",{"type":36,"tag":501,"props":1587,"children":1589},{"className":503,"code":1588,"language":505,"meta":506,"style":506},"\u002F\u002F Only POIs and addresses, no cities\n{\"q\": \"Paris\", \"types\": [\"poi\", \"address\"]}\n\u002F\u002F Returns Paris Hotel, Paris Street, not Paris, France\n\n\u002F\u002F Only places (cities)\n{\"q\": \"Paris\", \"types\": [\"place\"]}\n\u002F\u002F Returns Paris, France; Paris, Texas; etc.\n",[1590],{"type":36,"tag":509,"props":1591,"children":1592},{"__ignoreMap":506},[1593,1601,1695,1703,1712,1720,1795],{"type":36,"tag":513,"props":1594,"children":1595},{"class":515,"line":516},[1596],{"type":36,"tag":513,"props":1597,"children":1598},{"style":854},[1599],{"type":42,"value":1600},"\u002F\u002F Only POIs and addresses, no cities\n",{"type":36,"tag":513,"props":1602,"children":1603},{"class":515,"line":526},[1604,1609,1613,1617,1621,1625,1629,1633,1637,1641,1645,1650,1654,1658,1662,1666,1670,1674,1678,1682,1686,1690],{"type":36,"tag":513,"props":1605,"children":1606},{"style":520},[1607],{"type":42,"value":1608},"{",{"type":36,"tag":513,"props":1610,"children":1611},{"style":520},[1612],{"type":42,"value":543},{"type":36,"tag":513,"props":1614,"children":1615},{"style":535},[1616],{"type":42,"value":538},{"type":36,"tag":513,"props":1618,"children":1619},{"style":520},[1620],{"type":42,"value":543},{"type":36,"tag":513,"props":1622,"children":1623},{"style":520},[1624],{"type":42,"value":548},{"type":36,"tag":513,"props":1626,"children":1627},{"style":520},[1628],{"type":42,"value":553},{"type":36,"tag":513,"props":1630,"children":1631},{"style":556},[1632],{"type":42,"value":977},{"type":36,"tag":513,"props":1634,"children":1635},{"style":520},[1636],{"type":42,"value":543},{"type":36,"tag":513,"props":1638,"children":1639},{"style":520},[1640],{"type":42,"value":823},{"type":36,"tag":513,"props":1642,"children":1643},{"style":520},[1644],{"type":42,"value":553},{"type":36,"tag":513,"props":1646,"children":1647},{"style":535},[1648],{"type":42,"value":1649},"types",{"type":36,"tag":513,"props":1651,"children":1652},{"style":520},[1653],{"type":42,"value":543},{"type":36,"tag":513,"props":1655,"children":1656},{"style":520},[1657],{"type":42,"value":548},{"type":36,"tag":513,"props":1659,"children":1660},{"style":520},[1661],{"type":42,"value":813},{"type":36,"tag":513,"props":1663,"children":1664},{"style":520},[1665],{"type":42,"value":543},{"type":36,"tag":513,"props":1667,"children":1668},{"style":556},[1669],{"type":42,"value":1414},{"type":36,"tag":513,"props":1671,"children":1672},{"style":520},[1673],{"type":42,"value":543},{"type":36,"tag":513,"props":1675,"children":1676},{"style":520},[1677],{"type":42,"value":823},{"type":36,"tag":513,"props":1679,"children":1680},{"style":520},[1681],{"type":42,"value":553},{"type":36,"tag":513,"props":1683,"children":1684},{"style":556},[1685],{"type":42,"value":1436},{"type":36,"tag":513,"props":1687,"children":1688},{"style":520},[1689],{"type":42,"value":543},{"type":36,"tag":513,"props":1691,"children":1692},{"style":520},[1693],{"type":42,"value":1694},"]}\n",{"type":36,"tag":513,"props":1696,"children":1697},{"class":515,"line":571},[1698],{"type":36,"tag":513,"props":1699,"children":1700},{"style":854},[1701],{"type":42,"value":1702},"\u002F\u002F Returns Paris Hotel, Paris Street, not Paris, France\n",{"type":36,"tag":513,"props":1704,"children":1705},{"class":515,"line":597},[1706],{"type":36,"tag":513,"props":1707,"children":1709},{"emptyLinePlaceholder":1708},true,[1710],{"type":42,"value":1711},"\n",{"type":36,"tag":513,"props":1713,"children":1714},{"class":515,"line":630},[1715],{"type":36,"tag":513,"props":1716,"children":1717},{"style":854},[1718],{"type":42,"value":1719},"\u002F\u002F Only places (cities)\n",{"type":36,"tag":513,"props":1721,"children":1722},{"class":515,"line":656},[1723,1727,1731,1735,1739,1743,1747,1751,1755,1759,1763,1767,1771,1775,1779,1783,1787,1791],{"type":36,"tag":513,"props":1724,"children":1725},{"style":520},[1726],{"type":42,"value":1608},{"type":36,"tag":513,"props":1728,"children":1729},{"style":520},[1730],{"type":42,"value":543},{"type":36,"tag":513,"props":1732,"children":1733},{"style":535},[1734],{"type":42,"value":538},{"type":36,"tag":513,"props":1736,"children":1737},{"style":520},[1738],{"type":42,"value":543},{"type":36,"tag":513,"props":1740,"children":1741},{"style":520},[1742],{"type":42,"value":548},{"type":36,"tag":513,"props":1744,"children":1745},{"style":520},[1746],{"type":42,"value":553},{"type":36,"tag":513,"props":1748,"children":1749},{"style":556},[1750],{"type":42,"value":977},{"type":36,"tag":513,"props":1752,"children":1753},{"style":520},[1754],{"type":42,"value":543},{"type":36,"tag":513,"props":1756,"children":1757},{"style":520},[1758],{"type":42,"value":823},{"type":36,"tag":513,"props":1760,"children":1761},{"style":520},[1762],{"type":42,"value":553},{"type":36,"tag":513,"props":1764,"children":1765},{"style":535},[1766],{"type":42,"value":1649},{"type":36,"tag":513,"props":1768,"children":1769},{"style":520},[1770],{"type":42,"value":543},{"type":36,"tag":513,"props":1772,"children":1773},{"style":520},[1774],{"type":42,"value":548},{"type":36,"tag":513,"props":1776,"children":1777},{"style":520},[1778],{"type":42,"value":813},{"type":36,"tag":513,"props":1780,"children":1781},{"style":520},[1782],{"type":42,"value":543},{"type":36,"tag":513,"props":1784,"children":1785},{"style":556},[1786],{"type":42,"value":1458},{"type":36,"tag":513,"props":1788,"children":1789},{"style":520},[1790],{"type":42,"value":543},{"type":36,"tag":513,"props":1792,"children":1793},{"style":520},[1794],{"type":42,"value":1694},{"type":36,"tag":513,"props":1796,"children":1797},{"class":515,"line":665},[1798],{"type":36,"tag":513,"props":1799,"children":1800},{"style":854},[1801],{"type":42,"value":1802},"\u002F\u002F Returns Paris, France; Paris, Texas; etc.\n",{"type":36,"tag":45,"props":1804,"children":1805},{},[1806,1811],{"type":36,"tag":68,"props":1807,"children":1808},{},[1809],{"type":42,"value":1810},"Default behavior:",{"type":42,"value":1812}," All types included (usually what you want)",{"type":36,"tag":58,"props":1814,"children":1816},{"id":1815},"auto_complete-parameter-search_and_geocode_tool",[1817],{"type":42,"value":1818},"auto_complete Parameter (search_and_geocode_tool)",{"type":36,"tag":45,"props":1820,"children":1821},{},[1822,1826],{"type":36,"tag":68,"props":1823,"children":1824},{},[1825],{"type":42,"value":464},{"type":42,"value":1827}," Enables partial\u002Ffuzzy matching",{"type":36,"tag":225,"props":1829,"children":1830},{},[1831,1851],{"type":36,"tag":229,"props":1832,"children":1833},{},[1834],{"type":36,"tag":233,"props":1835,"children":1836},{},[1837,1842,1847],{"type":36,"tag":237,"props":1838,"children":1839},{},[1840],{"type":42,"value":1841},"Setting",{"type":36,"tag":237,"props":1843,"children":1844},{},[1845],{"type":42,"value":1846},"Behavior",{"type":36,"tag":237,"props":1848,"children":1849},{},[1850],{"type":42,"value":1399},{"type":36,"tag":253,"props":1852,"children":1853},{},[1854,1876],{"type":36,"tag":233,"props":1855,"children":1856},{},[1857,1866,1871],{"type":36,"tag":260,"props":1858,"children":1859},{},[1860],{"type":36,"tag":509,"props":1861,"children":1863},{"className":1862},[],[1864],{"type":42,"value":1865},"true",{"type":36,"tag":260,"props":1867,"children":1868},{},[1869],{"type":42,"value":1870},"Matches partial words, typos",{"type":36,"tag":260,"props":1872,"children":1873},{},[1874],{"type":42,"value":1875},"User typing in real-time",{"type":36,"tag":233,"props":1877,"children":1878},{},[1879,1890,1895],{"type":36,"tag":260,"props":1880,"children":1881},{},[1882,1888],{"type":36,"tag":509,"props":1883,"children":1885},{"className":1884},[],[1886],{"type":42,"value":1887},"false",{"type":42,"value":1889}," (default)",{"type":36,"tag":260,"props":1891,"children":1892},{},[1893],{"type":42,"value":1894},"Exact matching",{"type":36,"tag":260,"props":1896,"children":1897},{},[1898],{"type":42,"value":1899},"Final query, not autocomplete",{"type":36,"tag":45,"props":1901,"children":1902},{},[1903],{"type":36,"tag":68,"props":1904,"children":1905},{},[1906],{"type":42,"value":499},{"type":36,"tag":501,"props":1908,"children":1910},{"className":503,"code":1909,"language":505,"meta":506,"style":506},"\u002F\u002F User types \"starb\"\n{ \"q\": \"starb\", \"auto_complete\": true }\n\u002F\u002F Returns: Starbucks, Starboard Tavern, etc.\n",[1911],{"type":36,"tag":509,"props":1912,"children":1913},{"__ignoreMap":506},[1914,1922,1989],{"type":36,"tag":513,"props":1915,"children":1916},{"class":515,"line":516},[1917],{"type":36,"tag":513,"props":1918,"children":1919},{"style":854},[1920],{"type":42,"value":1921},"\u002F\u002F User types \"starb\"\n",{"type":36,"tag":513,"props":1923,"children":1924},{"class":515,"line":526},[1925,1929,1933,1937,1941,1945,1949,1954,1958,1962,1966,1971,1975,1979,1984],{"type":36,"tag":513,"props":1926,"children":1927},{"style":520},[1928],{"type":42,"value":1608},{"type":36,"tag":513,"props":1930,"children":1931},{"style":520},[1932],{"type":42,"value":553},{"type":36,"tag":513,"props":1934,"children":1935},{"style":535},[1936],{"type":42,"value":538},{"type":36,"tag":513,"props":1938,"children":1939},{"style":520},[1940],{"type":42,"value":543},{"type":36,"tag":513,"props":1942,"children":1943},{"style":520},[1944],{"type":42,"value":548},{"type":36,"tag":513,"props":1946,"children":1947},{"style":520},[1948],{"type":42,"value":553},{"type":36,"tag":513,"props":1950,"children":1951},{"style":556},[1952],{"type":42,"value":1953},"starb",{"type":36,"tag":513,"props":1955,"children":1956},{"style":520},[1957],{"type":42,"value":543},{"type":36,"tag":513,"props":1959,"children":1960},{"style":520},[1961],{"type":42,"value":823},{"type":36,"tag":513,"props":1963,"children":1964},{"style":520},[1965],{"type":42,"value":553},{"type":36,"tag":513,"props":1967,"children":1968},{"style":535},[1969],{"type":42,"value":1970},"auto_complete",{"type":36,"tag":513,"props":1972,"children":1973},{"style":520},[1974],{"type":42,"value":543},{"type":36,"tag":513,"props":1976,"children":1977},{"style":520},[1978],{"type":42,"value":548},{"type":36,"tag":513,"props":1980,"children":1981},{"style":520},[1982],{"type":42,"value":1983}," true",{"type":36,"tag":513,"props":1985,"children":1986},{"style":520},[1987],{"type":42,"value":1988}," }\n",{"type":36,"tag":513,"props":1990,"children":1991},{"class":515,"line":571},[1992],{"type":36,"tag":513,"props":1993,"children":1994},{"style":854},[1995],{"type":42,"value":1996},"\u002F\u002F Returns: Starbucks, Starboard Tavern, etc.\n",{"type":36,"tag":45,"props":1998,"children":1999},{},[2000],{"type":36,"tag":68,"props":2001,"children":2002},{},[2003],{"type":42,"value":2004},"Use for:",{"type":36,"tag":84,"props":2006,"children":2007},{},[2008,2013],{"type":36,"tag":88,"props":2009,"children":2010},{},[2011],{"type":42,"value":2012},"Search-as-you-type interfaces",{"type":36,"tag":88,"props":2014,"children":2015},{},[2016],{"type":42,"value":2017},"Handling typos (\"mcdonalds\" -> McDonald's)",{"type":36,"tag":84,"props":2019,"children":2020},{},[2021],{"type":36,"tag":88,"props":2022,"children":2023},{},[2024],{"type":42,"value":2025},"Incomplete queries",{"type":36,"tag":45,"props":2027,"children":2028},{},[2029],{"type":36,"tag":68,"props":2030,"children":2031},{},[2032],{"type":42,"value":120},{"type":36,"tag":84,"props":2034,"children":2035},{},[2036,2041],{"type":36,"tag":88,"props":2037,"children":2038},{},[2039],{"type":42,"value":2040},"Final\u002Fsubmitted queries (less precise)",{"type":36,"tag":88,"props":2042,"children":2043},{},[2044],{"type":42,"value":2045},"When you need exact matches",{"type":36,"tag":51,"props":2047,"children":2049},{"id":2048},"anti-patterns-to-avoid",[2050],{"type":42,"value":2051},"Anti-Patterns to Avoid",{"type":36,"tag":58,"props":2053,"children":2055},{"id":2054},"dont-use-category_search-for-brands",[2056],{"type":42,"value":2057},"Don't: Use category_search for brands",{"type":36,"tag":501,"props":2059,"children":2063},{"className":2060,"code":2061,"language":2062,"meta":506,"style":506},"language-javascript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u002F\u002F BAD\ncategory_search_tool({ category: 'starbucks' });\n\u002F\u002F \"starbucks\" is not a category, returns error\n\n\u002F\u002F GOOD\nsearch_and_geocode_tool({ q: 'Starbucks' });\n","javascript",[2064],{"type":36,"tag":509,"props":2065,"children":2066},{"__ignoreMap":506},[2067,2075,2133,2141,2148,2156],{"type":36,"tag":513,"props":2068,"children":2069},{"class":515,"line":516},[2070],{"type":36,"tag":513,"props":2071,"children":2072},{"style":854},[2073],{"type":42,"value":2074},"\u002F\u002F BAD\n",{"type":36,"tag":513,"props":2076,"children":2077},{"class":515,"line":526},[2078,2083,2089,2093,2099,2103,2108,2113,2118,2123,2128],{"type":36,"tag":513,"props":2079,"children":2081},{"style":2080},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[2082],{"type":42,"value":287},{"type":36,"tag":513,"props":2084,"children":2086},{"style":2085},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[2087],{"type":42,"value":2088},"(",{"type":36,"tag":513,"props":2090,"children":2091},{"style":520},[2092],{"type":42,"value":1608},{"type":36,"tag":513,"props":2094,"children":2096},{"style":2095},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[2097],{"type":42,"value":2098}," category",{"type":36,"tag":513,"props":2100,"children":2101},{"style":520},[2102],{"type":42,"value":548},{"type":36,"tag":513,"props":2104,"children":2105},{"style":520},[2106],{"type":42,"value":2107}," '",{"type":36,"tag":513,"props":2109,"children":2110},{"style":556},[2111],{"type":42,"value":2112},"starbucks",{"type":36,"tag":513,"props":2114,"children":2115},{"style":520},[2116],{"type":42,"value":2117},"'",{"type":36,"tag":513,"props":2119,"children":2120},{"style":520},[2121],{"type":42,"value":2122}," }",{"type":36,"tag":513,"props":2124,"children":2125},{"style":2085},[2126],{"type":42,"value":2127},")",{"type":36,"tag":513,"props":2129,"children":2130},{"style":520},[2131],{"type":42,"value":2132},";\n",{"type":36,"tag":513,"props":2134,"children":2135},{"class":515,"line":571},[2136],{"type":36,"tag":513,"props":2137,"children":2138},{"style":854},[2139],{"type":42,"value":2140},"\u002F\u002F \"starbucks\" is not a category, returns error\n",{"type":36,"tag":513,"props":2142,"children":2143},{"class":515,"line":597},[2144],{"type":36,"tag":513,"props":2145,"children":2146},{"emptyLinePlaceholder":1708},[2147],{"type":42,"value":1711},{"type":36,"tag":513,"props":2149,"children":2150},{"class":515,"line":630},[2151],{"type":36,"tag":513,"props":2152,"children":2153},{"style":854},[2154],{"type":42,"value":2155},"\u002F\u002F GOOD\n",{"type":36,"tag":513,"props":2157,"children":2158},{"class":515,"line":656},[2159,2163,2167,2171,2176,2180,2184,2189,2193,2197,2201],{"type":36,"tag":513,"props":2160,"children":2161},{"style":2080},[2162],{"type":42,"value":269},{"type":36,"tag":513,"props":2164,"children":2165},{"style":2085},[2166],{"type":42,"value":2088},{"type":36,"tag":513,"props":2168,"children":2169},{"style":520},[2170],{"type":42,"value":1608},{"type":36,"tag":513,"props":2172,"children":2173},{"style":2095},[2174],{"type":42,"value":2175}," q",{"type":36,"tag":513,"props":2177,"children":2178},{"style":520},[2179],{"type":42,"value":548},{"type":36,"tag":513,"props":2181,"children":2182},{"style":520},[2183],{"type":42,"value":2107},{"type":36,"tag":513,"props":2185,"children":2186},{"style":556},[2187],{"type":42,"value":2188},"Starbucks",{"type":36,"tag":513,"props":2190,"children":2191},{"style":520},[2192],{"type":42,"value":2117},{"type":36,"tag":513,"props":2194,"children":2195},{"style":520},[2196],{"type":42,"value":2122},{"type":36,"tag":513,"props":2198,"children":2199},{"style":2085},[2200],{"type":42,"value":2127},{"type":36,"tag":513,"props":2202,"children":2203},{"style":520},[2204],{"type":42,"value":2132},{"type":36,"tag":58,"props":2206,"children":2208},{"id":2207},"dont-use-search_and_geocode-for-generic-categories",[2209],{"type":42,"value":2210},"Don't: Use search_and_geocode for generic categories",{"type":36,"tag":501,"props":2212,"children":2214},{"className":2060,"code":2213,"language":2062,"meta":506,"style":506},"\u002F\u002F BAD\nsearch_and_geocode_tool({ q: 'coffee shops' });\n\u002F\u002F Less precise, may return unrelated results\n\n\u002F\u002F GOOD\ncategory_search_tool({ category: 'coffee_shop' });\n",[2215],{"type":36,"tag":509,"props":2216,"children":2217},{"__ignoreMap":506},[2218,2225,2273,2281,2288,2295],{"type":36,"tag":513,"props":2219,"children":2220},{"class":515,"line":516},[2221],{"type":36,"tag":513,"props":2222,"children":2223},{"style":854},[2224],{"type":42,"value":2074},{"type":36,"tag":513,"props":2226,"children":2227},{"class":515,"line":526},[2228,2232,2236,2240,2244,2248,2252,2257,2261,2265,2269],{"type":36,"tag":513,"props":2229,"children":2230},{"style":2080},[2231],{"type":42,"value":269},{"type":36,"tag":513,"props":2233,"children":2234},{"style":2085},[2235],{"type":42,"value":2088},{"type":36,"tag":513,"props":2237,"children":2238},{"style":520},[2239],{"type":42,"value":1608},{"type":36,"tag":513,"props":2241,"children":2242},{"style":2095},[2243],{"type":42,"value":2175},{"type":36,"tag":513,"props":2245,"children":2246},{"style":520},[2247],{"type":42,"value":548},{"type":36,"tag":513,"props":2249,"children":2250},{"style":520},[2251],{"type":42,"value":2107},{"type":36,"tag":513,"props":2253,"children":2254},{"style":556},[2255],{"type":42,"value":2256},"coffee shops",{"type":36,"tag":513,"props":2258,"children":2259},{"style":520},[2260],{"type":42,"value":2117},{"type":36,"tag":513,"props":2262,"children":2263},{"style":520},[2264],{"type":42,"value":2122},{"type":36,"tag":513,"props":2266,"children":2267},{"style":2085},[2268],{"type":42,"value":2127},{"type":36,"tag":513,"props":2270,"children":2271},{"style":520},[2272],{"type":42,"value":2132},{"type":36,"tag":513,"props":2274,"children":2275},{"class":515,"line":571},[2276],{"type":36,"tag":513,"props":2277,"children":2278},{"style":854},[2279],{"type":42,"value":2280},"\u002F\u002F Less precise, may return unrelated results\n",{"type":36,"tag":513,"props":2282,"children":2283},{"class":515,"line":597},[2284],{"type":36,"tag":513,"props":2285,"children":2286},{"emptyLinePlaceholder":1708},[2287],{"type":42,"value":1711},{"type":36,"tag":513,"props":2289,"children":2290},{"class":515,"line":630},[2291],{"type":36,"tag":513,"props":2292,"children":2293},{"style":854},[2294],{"type":42,"value":2155},{"type":36,"tag":513,"props":2296,"children":2297},{"class":515,"line":656},[2298,2302,2306,2310,2314,2318,2322,2327,2331,2335,2339],{"type":36,"tag":513,"props":2299,"children":2300},{"style":2080},[2301],{"type":42,"value":287},{"type":36,"tag":513,"props":2303,"children":2304},{"style":2085},[2305],{"type":42,"value":2088},{"type":36,"tag":513,"props":2307,"children":2308},{"style":520},[2309],{"type":42,"value":1608},{"type":36,"tag":513,"props":2311,"children":2312},{"style":2095},[2313],{"type":42,"value":2098},{"type":36,"tag":513,"props":2315,"children":2316},{"style":520},[2317],{"type":42,"value":548},{"type":36,"tag":513,"props":2319,"children":2320},{"style":520},[2321],{"type":42,"value":2107},{"type":36,"tag":513,"props":2323,"children":2324},{"style":556},[2325],{"type":42,"value":2326},"coffee_shop",{"type":36,"tag":513,"props":2328,"children":2329},{"style":520},[2330],{"type":42,"value":2117},{"type":36,"tag":513,"props":2332,"children":2333},{"style":520},[2334],{"type":42,"value":2122},{"type":36,"tag":513,"props":2336,"children":2337},{"style":2085},[2338],{"type":42,"value":2127},{"type":36,"tag":513,"props":2340,"children":2341},{"style":520},[2342],{"type":42,"value":2132},{"type":36,"tag":58,"props":2344,"children":2346},{"id":2345},"dont-forget-proximity-for-local-searches",[2347],{"type":42,"value":2348},"Don't: Forget proximity for local searches",{"type":36,"tag":501,"props":2350,"children":2352},{"className":2060,"code":2351,"language":2062,"meta":506,"style":506},"\u002F\u002F BAD - Results may be anywhere globally\ncategory_search_tool({ category: 'restaurant' });\n\n\u002F\u002F GOOD - Biased to user location\ncategory_search_tool({\n  category: 'restaurant',\n  proximity: { longitude: -122.4194, latitude: 37.7749 }\n});\n",[2353],{"type":36,"tag":509,"props":2354,"children":2355},{"__ignoreMap":506},[2356,2364,2412,2419,2427,2442,2470,2528],{"type":36,"tag":513,"props":2357,"children":2358},{"class":515,"line":516},[2359],{"type":36,"tag":513,"props":2360,"children":2361},{"style":854},[2362],{"type":42,"value":2363},"\u002F\u002F BAD - Results may be anywhere globally\n",{"type":36,"tag":513,"props":2365,"children":2366},{"class":515,"line":526},[2367,2371,2375,2379,2383,2387,2391,2396,2400,2404,2408],{"type":36,"tag":513,"props":2368,"children":2369},{"style":2080},[2370],{"type":42,"value":287},{"type":36,"tag":513,"props":2372,"children":2373},{"style":2085},[2374],{"type":42,"value":2088},{"type":36,"tag":513,"props":2376,"children":2377},{"style":520},[2378],{"type":42,"value":1608},{"type":36,"tag":513,"props":2380,"children":2381},{"style":2095},[2382],{"type":42,"value":2098},{"type":36,"tag":513,"props":2384,"children":2385},{"style":520},[2386],{"type":42,"value":548},{"type":36,"tag":513,"props":2388,"children":2389},{"style":520},[2390],{"type":42,"value":2107},{"type":36,"tag":513,"props":2392,"children":2393},{"style":556},[2394],{"type":42,"value":2395},"restaurant",{"type":36,"tag":513,"props":2397,"children":2398},{"style":520},[2399],{"type":42,"value":2117},{"type":36,"tag":513,"props":2401,"children":2402},{"style":520},[2403],{"type":42,"value":2122},{"type":36,"tag":513,"props":2405,"children":2406},{"style":2085},[2407],{"type":42,"value":2127},{"type":36,"tag":513,"props":2409,"children":2410},{"style":520},[2411],{"type":42,"value":2132},{"type":36,"tag":513,"props":2413,"children":2414},{"class":515,"line":571},[2415],{"type":36,"tag":513,"props":2416,"children":2417},{"emptyLinePlaceholder":1708},[2418],{"type":42,"value":1711},{"type":36,"tag":513,"props":2420,"children":2421},{"class":515,"line":597},[2422],{"type":36,"tag":513,"props":2423,"children":2424},{"style":854},[2425],{"type":42,"value":2426},"\u002F\u002F GOOD - Biased to user location\n",{"type":36,"tag":513,"props":2428,"children":2429},{"class":515,"line":630},[2430,2434,2438],{"type":36,"tag":513,"props":2431,"children":2432},{"style":2080},[2433],{"type":42,"value":287},{"type":36,"tag":513,"props":2435,"children":2436},{"style":2085},[2437],{"type":42,"value":2088},{"type":36,"tag":513,"props":2439,"children":2440},{"style":520},[2441],{"type":42,"value":523},{"type":36,"tag":513,"props":2443,"children":2444},{"class":515,"line":656},[2445,2450,2454,2458,2462,2466],{"type":36,"tag":513,"props":2446,"children":2447},{"style":2095},[2448],{"type":42,"value":2449},"  category",{"type":36,"tag":513,"props":2451,"children":2452},{"style":520},[2453],{"type":42,"value":548},{"type":36,"tag":513,"props":2455,"children":2456},{"style":520},[2457],{"type":42,"value":2107},{"type":36,"tag":513,"props":2459,"children":2460},{"style":556},[2461],{"type":42,"value":2395},{"type":36,"tag":513,"props":2463,"children":2464},{"style":520},[2465],{"type":42,"value":2117},{"type":36,"tag":513,"props":2467,"children":2468},{"style":520},[2469],{"type":42,"value":568},{"type":36,"tag":513,"props":2471,"children":2472},{"class":515,"line":665},[2473,2478,2482,2487,2492,2496,2501,2506,2510,2515,2519,2524],{"type":36,"tag":513,"props":2474,"children":2475},{"style":2095},[2476],{"type":42,"value":2477},"  proximity",{"type":36,"tag":513,"props":2479,"children":2480},{"style":520},[2481],{"type":42,"value":548},{"type":36,"tag":513,"props":2483,"children":2484},{"style":520},[2485],{"type":42,"value":2486}," {",{"type":36,"tag":513,"props":2488,"children":2489},{"style":2095},[2490],{"type":42,"value":2491}," longitude",{"type":36,"tag":513,"props":2493,"children":2494},{"style":520},[2495],{"type":42,"value":548},{"type":36,"tag":513,"props":2497,"children":2498},{"style":520},[2499],{"type":42,"value":2500}," -",{"type":36,"tag":513,"props":2502,"children":2503},{"style":620},[2504],{"type":42,"value":2505},"122.4194",{"type":36,"tag":513,"props":2507,"children":2508},{"style":520},[2509],{"type":42,"value":823},{"type":36,"tag":513,"props":2511,"children":2512},{"style":2095},[2513],{"type":42,"value":2514}," latitude",{"type":36,"tag":513,"props":2516,"children":2517},{"style":520},[2518],{"type":42,"value":548},{"type":36,"tag":513,"props":2520,"children":2521},{"style":620},[2522],{"type":42,"value":2523}," 37.7749",{"type":36,"tag":513,"props":2525,"children":2526},{"style":520},[2527],{"type":42,"value":1988},{"type":36,"tag":513,"props":2529,"children":2531},{"class":515,"line":2530},8,[2532,2537,2541],{"type":36,"tag":513,"props":2533,"children":2534},{"style":520},[2535],{"type":42,"value":2536},"}",{"type":36,"tag":513,"props":2538,"children":2539},{"style":2085},[2540],{"type":42,"value":2127},{"type":36,"tag":513,"props":2542,"children":2543},{"style":520},[2544],{"type":42,"value":2132},{"type":36,"tag":58,"props":2546,"children":2548},{"id":2547},"dont-geocode-ambiguous-place-names-without-proximity-rest-too",[2549],{"type":42,"value":2550},"Don't: Geocode ambiguous place names without proximity (REST too)",{"type":36,"tag":45,"props":2552,"children":2553},{},[2554],{"type":42,"value":2555},"This applies to Mapbox Geocoding API v5 \u002F Search Box in browser apps — not only MCP tools.",{"type":36,"tag":501,"props":2557,"children":2559},{"className":2060,"code":2558,"language":2062,"meta":506,"style":506},"\u002F\u002F BAD — limit=1 without proximity can resolve \"Lincoln Memorial\" to Illinois\nfetch(`https:\u002F\u002Fapi.mapbox.com\u002Fgeocoding\u002Fv5\u002Fmapbox.places\u002F${encodeURIComponent(q)}.json?access_token=${token}&limit=1`);\n\n\u002F\u002F GOOD — bias to map center (and optional bbox)\nfetch(\n  `https:\u002F\u002Fapi.mapbox.com\u002Fgeocoding\u002Fv5\u002Fmapbox.places\u002F${encodeURIComponent(q)}.json` +\n    `?access_token=${token}&proximity=-77.0369,38.9072&bbox=-77.15,38.79,-76.90,38.99&limit=1`\n);\n",[2560],{"type":36,"tag":509,"props":2561,"children":2562},{"__ignoreMap":506},[2563,2571,2647,2654,2662,2674,2716,2751],{"type":36,"tag":513,"props":2564,"children":2565},{"class":515,"line":516},[2566],{"type":36,"tag":513,"props":2567,"children":2568},{"style":854},[2569],{"type":42,"value":2570},"\u002F\u002F BAD — limit=1 without proximity can resolve \"Lincoln Memorial\" to Illinois\n",{"type":36,"tag":513,"props":2572,"children":2573},{"class":515,"line":526},[2574,2579,2583,2588,2593,2598,2603,2608,2612,2617,2621,2626,2630,2635,2639,2643],{"type":36,"tag":513,"props":2575,"children":2576},{"style":2080},[2577],{"type":42,"value":2578},"fetch",{"type":36,"tag":513,"props":2580,"children":2581},{"style":2085},[2582],{"type":42,"value":2088},{"type":36,"tag":513,"props":2584,"children":2585},{"style":520},[2586],{"type":42,"value":2587},"`",{"type":36,"tag":513,"props":2589,"children":2590},{"style":556},[2591],{"type":42,"value":2592},"https:\u002F\u002Fapi.mapbox.com\u002Fgeocoding\u002Fv5\u002Fmapbox.places\u002F",{"type":36,"tag":513,"props":2594,"children":2595},{"style":520},[2596],{"type":42,"value":2597},"${",{"type":36,"tag":513,"props":2599,"children":2600},{"style":2080},[2601],{"type":42,"value":2602},"encodeURIComponent",{"type":36,"tag":513,"props":2604,"children":2605},{"style":2085},[2606],{"type":42,"value":2607},"(q)",{"type":36,"tag":513,"props":2609,"children":2610},{"style":520},[2611],{"type":42,"value":2536},{"type":36,"tag":513,"props":2613,"children":2614},{"style":556},[2615],{"type":42,"value":2616},".json?access_token=",{"type":36,"tag":513,"props":2618,"children":2619},{"style":520},[2620],{"type":42,"value":2597},{"type":36,"tag":513,"props":2622,"children":2623},{"style":2085},[2624],{"type":42,"value":2625},"token",{"type":36,"tag":513,"props":2627,"children":2628},{"style":520},[2629],{"type":42,"value":2536},{"type":36,"tag":513,"props":2631,"children":2632},{"style":556},[2633],{"type":42,"value":2634},"&limit=1",{"type":36,"tag":513,"props":2636,"children":2637},{"style":520},[2638],{"type":42,"value":2587},{"type":36,"tag":513,"props":2640,"children":2641},{"style":2085},[2642],{"type":42,"value":2127},{"type":36,"tag":513,"props":2644,"children":2645},{"style":520},[2646],{"type":42,"value":2132},{"type":36,"tag":513,"props":2648,"children":2649},{"class":515,"line":571},[2650],{"type":36,"tag":513,"props":2651,"children":2652},{"emptyLinePlaceholder":1708},[2653],{"type":42,"value":1711},{"type":36,"tag":513,"props":2655,"children":2656},{"class":515,"line":597},[2657],{"type":36,"tag":513,"props":2658,"children":2659},{"style":854},[2660],{"type":42,"value":2661},"\u002F\u002F GOOD — bias to map center (and optional bbox)\n",{"type":36,"tag":513,"props":2663,"children":2664},{"class":515,"line":630},[2665,2669],{"type":36,"tag":513,"props":2666,"children":2667},{"style":2080},[2668],{"type":42,"value":2578},{"type":36,"tag":513,"props":2670,"children":2671},{"style":2085},[2672],{"type":42,"value":2673},"(\n",{"type":36,"tag":513,"props":2675,"children":2676},{"class":515,"line":656},[2677,2682,2686,2690,2694,2698,2702,2707,2711],{"type":36,"tag":513,"props":2678,"children":2679},{"style":520},[2680],{"type":42,"value":2681},"  `",{"type":36,"tag":513,"props":2683,"children":2684},{"style":556},[2685],{"type":42,"value":2592},{"type":36,"tag":513,"props":2687,"children":2688},{"style":520},[2689],{"type":42,"value":2597},{"type":36,"tag":513,"props":2691,"children":2692},{"style":2080},[2693],{"type":42,"value":2602},{"type":36,"tag":513,"props":2695,"children":2696},{"style":2085},[2697],{"type":42,"value":2607},{"type":36,"tag":513,"props":2699,"children":2700},{"style":520},[2701],{"type":42,"value":2536},{"type":36,"tag":513,"props":2703,"children":2704},{"style":556},[2705],{"type":42,"value":2706},".json",{"type":36,"tag":513,"props":2708,"children":2709},{"style":520},[2710],{"type":42,"value":2587},{"type":36,"tag":513,"props":2712,"children":2713},{"style":520},[2714],{"type":42,"value":2715}," +\n",{"type":36,"tag":513,"props":2717,"children":2718},{"class":515,"line":665},[2719,2724,2729,2733,2737,2741,2746],{"type":36,"tag":513,"props":2720,"children":2721},{"style":520},[2722],{"type":42,"value":2723},"    `",{"type":36,"tag":513,"props":2725,"children":2726},{"style":556},[2727],{"type":42,"value":2728},"?access_token=",{"type":36,"tag":513,"props":2730,"children":2731},{"style":520},[2732],{"type":42,"value":2597},{"type":36,"tag":513,"props":2734,"children":2735},{"style":2085},[2736],{"type":42,"value":2625},{"type":36,"tag":513,"props":2738,"children":2739},{"style":520},[2740],{"type":42,"value":2536},{"type":36,"tag":513,"props":2742,"children":2743},{"style":556},[2744],{"type":42,"value":2745},"&proximity=-77.0369,38.9072&bbox=-77.15,38.79,-76.90,38.99&limit=1",{"type":36,"tag":513,"props":2747,"children":2748},{"style":520},[2749],{"type":42,"value":2750},"`\n",{"type":36,"tag":513,"props":2752,"children":2753},{"class":515,"line":2530},[2754,2758],{"type":36,"tag":513,"props":2755,"children":2756},{"style":2085},[2757],{"type":42,"value":2127},{"type":36,"tag":513,"props":2759,"children":2760},{"style":520},[2761],{"type":42,"value":2132},{"type":36,"tag":45,"props":2763,"children":2764},{},[2765,2767,2773,2774,2780],{"type":42,"value":2766},"Also debounce search inputs (",{"type":36,"tag":509,"props":2768,"children":2770},{"className":2769},[],[2771],{"type":42,"value":2772},"clearTimeout",{"type":42,"value":1064},{"type":36,"tag":509,"props":2775,"children":2777},{"className":2776},[],[2778],{"type":42,"value":2779},"setTimeout",{"type":42,"value":2781},") so every keystroke does not fire a geocode.",{"type":36,"tag":58,"props":2783,"children":2785},{"id":2784},"dont-use-bbox-when-you-mean-proximity",[2786],{"type":42,"value":2787},"Don't: Use bbox when you mean proximity",{"type":36,"tag":501,"props":2789,"children":2791},{"className":2060,"code":2790,"language":2062,"meta":506,"style":506},"\u002F\u002F BAD - Hard boundary may exclude good nearby results\nsearch_and_geocode_tool({\n  q: 'pizza',\n  bbox: [-122.42, 37.77, -122.41, 37.78] \u002F\u002F Tiny box\n});\n\n\u002F\u002F GOOD - Bias toward point, but flexible\nsearch_and_geocode_tool({\n  q: 'pizza',\n  proximity: { longitude: -122.4194, latitude: 37.7749 }\n});\n",[2792],{"type":36,"tag":509,"props":2793,"children":2794},{"__ignoreMap":506},[2795,2803,2818,2846,2913,2928,2935,2943,2958,2986,3037],{"type":36,"tag":513,"props":2796,"children":2797},{"class":515,"line":516},[2798],{"type":36,"tag":513,"props":2799,"children":2800},{"style":854},[2801],{"type":42,"value":2802},"\u002F\u002F BAD - Hard boundary may exclude good nearby results\n",{"type":36,"tag":513,"props":2804,"children":2805},{"class":515,"line":526},[2806,2810,2814],{"type":36,"tag":513,"props":2807,"children":2808},{"style":2080},[2809],{"type":42,"value":269},{"type":36,"tag":513,"props":2811,"children":2812},{"style":2085},[2813],{"type":42,"value":2088},{"type":36,"tag":513,"props":2815,"children":2816},{"style":520},[2817],{"type":42,"value":523},{"type":36,"tag":513,"props":2819,"children":2820},{"class":515,"line":571},[2821,2826,2830,2834,2838,2842],{"type":36,"tag":513,"props":2822,"children":2823},{"style":2095},[2824],{"type":42,"value":2825},"  q",{"type":36,"tag":513,"props":2827,"children":2828},{"style":520},[2829],{"type":42,"value":548},{"type":36,"tag":513,"props":2831,"children":2832},{"style":520},[2833],{"type":42,"value":2107},{"type":36,"tag":513,"props":2835,"children":2836},{"style":556},[2837],{"type":42,"value":559},{"type":36,"tag":513,"props":2839,"children":2840},{"style":520},[2841],{"type":42,"value":2117},{"type":36,"tag":513,"props":2843,"children":2844},{"style":520},[2845],{"type":42,"value":568},{"type":36,"tag":513,"props":2847,"children":2848},{"class":515,"line":597},[2849,2854,2858,2862,2867,2872,2876,2881,2885,2889,2894,2898,2903,2908],{"type":36,"tag":513,"props":2850,"children":2851},{"style":2095},[2852],{"type":42,"value":2853},"  bbox",{"type":36,"tag":513,"props":2855,"children":2856},{"style":520},[2857],{"type":42,"value":548},{"type":36,"tag":513,"props":2859,"children":2860},{"style":2085},[2861],{"type":42,"value":813},{"type":36,"tag":513,"props":2863,"children":2864},{"style":520},[2865],{"type":42,"value":2866},"-",{"type":36,"tag":513,"props":2868,"children":2869},{"style":620},[2870],{"type":42,"value":2871},"122.42",{"type":36,"tag":513,"props":2873,"children":2874},{"style":520},[2875],{"type":42,"value":823},{"type":36,"tag":513,"props":2877,"children":2878},{"style":620},[2879],{"type":42,"value":2880}," 37.77",{"type":36,"tag":513,"props":2882,"children":2883},{"style":520},[2884],{"type":42,"value":823},{"type":36,"tag":513,"props":2886,"children":2887},{"style":520},[2888],{"type":42,"value":2500},{"type":36,"tag":513,"props":2890,"children":2891},{"style":620},[2892],{"type":42,"value":2893},"122.41",{"type":36,"tag":513,"props":2895,"children":2896},{"style":520},[2897],{"type":42,"value":823},{"type":36,"tag":513,"props":2899,"children":2900},{"style":620},[2901],{"type":42,"value":2902}," 37.78",{"type":36,"tag":513,"props":2904,"children":2905},{"style":2085},[2906],{"type":42,"value":2907},"] ",{"type":36,"tag":513,"props":2909,"children":2910},{"style":854},[2911],{"type":42,"value":2912},"\u002F\u002F Tiny box\n",{"type":36,"tag":513,"props":2914,"children":2915},{"class":515,"line":630},[2916,2920,2924],{"type":36,"tag":513,"props":2917,"children":2918},{"style":520},[2919],{"type":42,"value":2536},{"type":36,"tag":513,"props":2921,"children":2922},{"style":2085},[2923],{"type":42,"value":2127},{"type":36,"tag":513,"props":2925,"children":2926},{"style":520},[2927],{"type":42,"value":2132},{"type":36,"tag":513,"props":2929,"children":2930},{"class":515,"line":656},[2931],{"type":36,"tag":513,"props":2932,"children":2933},{"emptyLinePlaceholder":1708},[2934],{"type":42,"value":1711},{"type":36,"tag":513,"props":2936,"children":2937},{"class":515,"line":665},[2938],{"type":36,"tag":513,"props":2939,"children":2940},{"style":854},[2941],{"type":42,"value":2942},"\u002F\u002F GOOD - Bias toward point, but flexible\n",{"type":36,"tag":513,"props":2944,"children":2945},{"class":515,"line":2530},[2946,2950,2954],{"type":36,"tag":513,"props":2947,"children":2948},{"style":2080},[2949],{"type":42,"value":269},{"type":36,"tag":513,"props":2951,"children":2952},{"style":2085},[2953],{"type":42,"value":2088},{"type":36,"tag":513,"props":2955,"children":2956},{"style":520},[2957],{"type":42,"value":523},{"type":36,"tag":513,"props":2959,"children":2961},{"class":515,"line":2960},9,[2962,2966,2970,2974,2978,2982],{"type":36,"tag":513,"props":2963,"children":2964},{"style":2095},[2965],{"type":42,"value":2825},{"type":36,"tag":513,"props":2967,"children":2968},{"style":520},[2969],{"type":42,"value":548},{"type":36,"tag":513,"props":2971,"children":2972},{"style":520},[2973],{"type":42,"value":2107},{"type":36,"tag":513,"props":2975,"children":2976},{"style":556},[2977],{"type":42,"value":559},{"type":36,"tag":513,"props":2979,"children":2980},{"style":520},[2981],{"type":42,"value":2117},{"type":36,"tag":513,"props":2983,"children":2984},{"style":520},[2985],{"type":42,"value":568},{"type":36,"tag":513,"props":2987,"children":2988},{"class":515,"line":24},[2989,2993,2997,3001,3005,3009,3013,3017,3021,3025,3029,3033],{"type":36,"tag":513,"props":2990,"children":2991},{"style":2095},[2992],{"type":42,"value":2477},{"type":36,"tag":513,"props":2994,"children":2995},{"style":520},[2996],{"type":42,"value":548},{"type":36,"tag":513,"props":2998,"children":2999},{"style":520},[3000],{"type":42,"value":2486},{"type":36,"tag":513,"props":3002,"children":3003},{"style":2095},[3004],{"type":42,"value":2491},{"type":36,"tag":513,"props":3006,"children":3007},{"style":520},[3008],{"type":42,"value":548},{"type":36,"tag":513,"props":3010,"children":3011},{"style":520},[3012],{"type":42,"value":2500},{"type":36,"tag":513,"props":3014,"children":3015},{"style":620},[3016],{"type":42,"value":2505},{"type":36,"tag":513,"props":3018,"children":3019},{"style":520},[3020],{"type":42,"value":823},{"type":36,"tag":513,"props":3022,"children":3023},{"style":2095},[3024],{"type":42,"value":2514},{"type":36,"tag":513,"props":3026,"children":3027},{"style":520},[3028],{"type":42,"value":548},{"type":36,"tag":513,"props":3030,"children":3031},{"style":620},[3032],{"type":42,"value":2523},{"type":36,"tag":513,"props":3034,"children":3035},{"style":520},[3036],{"type":42,"value":1988},{"type":36,"tag":513,"props":3038,"children":3040},{"class":515,"line":3039},11,[3041,3045,3049],{"type":36,"tag":513,"props":3042,"children":3043},{"style":520},[3044],{"type":42,"value":2536},{"type":36,"tag":513,"props":3046,"children":3047},{"style":2085},[3048],{"type":42,"value":2127},{"type":36,"tag":513,"props":3050,"children":3051},{"style":520},[3052],{"type":42,"value":2132},{"type":36,"tag":58,"props":3054,"children":3056},{"id":3055},"dont-request-eta-unnecessarily",[3057],{"type":42,"value":3058},"Don't: Request ETA unnecessarily",{"type":36,"tag":501,"props":3060,"children":3062},{"className":2060,"code":3061,"language":2062,"meta":506,"style":506},"\u002F\u002F BAD - Costs API quota for routing calculations\nsearch_and_geocode_tool({\n  q: 'museums',\n  eta_type: 'navigation',\n  navigation_profile: 'driving'\n});\n\u002F\u002F User didn't ask for travel time!\n\n\u002F\u002F GOOD - Only add ETA when needed\nsearch_and_geocode_tool({ q: 'museums' });\n\u002F\u002F If user asks \"how long to get there?\", then add ETA\n",[3063],{"type":36,"tag":509,"props":3064,"children":3065},{"__ignoreMap":506},[3066,3074,3089,3117,3146,3172,3187,3195,3202,3210,3257],{"type":36,"tag":513,"props":3067,"children":3068},{"class":515,"line":516},[3069],{"type":36,"tag":513,"props":3070,"children":3071},{"style":854},[3072],{"type":42,"value":3073},"\u002F\u002F BAD - Costs API quota for routing calculations\n",{"type":36,"tag":513,"props":3075,"children":3076},{"class":515,"line":526},[3077,3081,3085],{"type":36,"tag":513,"props":3078,"children":3079},{"style":2080},[3080],{"type":42,"value":269},{"type":36,"tag":513,"props":3082,"children":3083},{"style":2085},[3084],{"type":42,"value":2088},{"type":36,"tag":513,"props":3086,"children":3087},{"style":520},[3088],{"type":42,"value":523},{"type":36,"tag":513,"props":3090,"children":3091},{"class":515,"line":571},[3092,3096,3100,3104,3109,3113],{"type":36,"tag":513,"props":3093,"children":3094},{"style":2095},[3095],{"type":42,"value":2825},{"type":36,"tag":513,"props":3097,"children":3098},{"style":520},[3099],{"type":42,"value":548},{"type":36,"tag":513,"props":3101,"children":3102},{"style":520},[3103],{"type":42,"value":2107},{"type":36,"tag":513,"props":3105,"children":3106},{"style":556},[3107],{"type":42,"value":3108},"museums",{"type":36,"tag":513,"props":3110,"children":3111},{"style":520},[3112],{"type":42,"value":2117},{"type":36,"tag":513,"props":3114,"children":3115},{"style":520},[3116],{"type":42,"value":568},{"type":36,"tag":513,"props":3118,"children":3119},{"class":515,"line":597},[3120,3125,3129,3133,3138,3142],{"type":36,"tag":513,"props":3121,"children":3122},{"style":2095},[3123],{"type":42,"value":3124},"  eta_type",{"type":36,"tag":513,"props":3126,"children":3127},{"style":520},[3128],{"type":42,"value":548},{"type":36,"tag":513,"props":3130,"children":3131},{"style":520},[3132],{"type":42,"value":2107},{"type":36,"tag":513,"props":3134,"children":3135},{"style":556},[3136],{"type":42,"value":3137},"navigation",{"type":36,"tag":513,"props":3139,"children":3140},{"style":520},[3141],{"type":42,"value":2117},{"type":36,"tag":513,"props":3143,"children":3144},{"style":520},[3145],{"type":42,"value":568},{"type":36,"tag":513,"props":3147,"children":3148},{"class":515,"line":630},[3149,3154,3158,3162,3167],{"type":36,"tag":513,"props":3150,"children":3151},{"style":2095},[3152],{"type":42,"value":3153},"  navigation_profile",{"type":36,"tag":513,"props":3155,"children":3156},{"style":520},[3157],{"type":42,"value":548},{"type":36,"tag":513,"props":3159,"children":3160},{"style":520},[3161],{"type":42,"value":2107},{"type":36,"tag":513,"props":3163,"children":3164},{"style":556},[3165],{"type":42,"value":3166},"driving",{"type":36,"tag":513,"props":3168,"children":3169},{"style":520},[3170],{"type":42,"value":3171},"'\n",{"type":36,"tag":513,"props":3173,"children":3174},{"class":515,"line":656},[3175,3179,3183],{"type":36,"tag":513,"props":3176,"children":3177},{"style":520},[3178],{"type":42,"value":2536},{"type":36,"tag":513,"props":3180,"children":3181},{"style":2085},[3182],{"type":42,"value":2127},{"type":36,"tag":513,"props":3184,"children":3185},{"style":520},[3186],{"type":42,"value":2132},{"type":36,"tag":513,"props":3188,"children":3189},{"class":515,"line":665},[3190],{"type":36,"tag":513,"props":3191,"children":3192},{"style":854},[3193],{"type":42,"value":3194},"\u002F\u002F User didn't ask for travel time!\n",{"type":36,"tag":513,"props":3196,"children":3197},{"class":515,"line":2530},[3198],{"type":36,"tag":513,"props":3199,"children":3200},{"emptyLinePlaceholder":1708},[3201],{"type":42,"value":1711},{"type":36,"tag":513,"props":3203,"children":3204},{"class":515,"line":2960},[3205],{"type":36,"tag":513,"props":3206,"children":3207},{"style":854},[3208],{"type":42,"value":3209},"\u002F\u002F GOOD - Only add ETA when needed\n",{"type":36,"tag":513,"props":3211,"children":3212},{"class":515,"line":24},[3213,3217,3221,3225,3229,3233,3237,3241,3245,3249,3253],{"type":36,"tag":513,"props":3214,"children":3215},{"style":2080},[3216],{"type":42,"value":269},{"type":36,"tag":513,"props":3218,"children":3219},{"style":2085},[3220],{"type":42,"value":2088},{"type":36,"tag":513,"props":3222,"children":3223},{"style":520},[3224],{"type":42,"value":1608},{"type":36,"tag":513,"props":3226,"children":3227},{"style":2095},[3228],{"type":42,"value":2175},{"type":36,"tag":513,"props":3230,"children":3231},{"style":520},[3232],{"type":42,"value":548},{"type":36,"tag":513,"props":3234,"children":3235},{"style":520},[3236],{"type":42,"value":2107},{"type":36,"tag":513,"props":3238,"children":3239},{"style":556},[3240],{"type":42,"value":3108},{"type":36,"tag":513,"props":3242,"children":3243},{"style":520},[3244],{"type":42,"value":2117},{"type":36,"tag":513,"props":3246,"children":3247},{"style":520},[3248],{"type":42,"value":2122},{"type":36,"tag":513,"props":3250,"children":3251},{"style":2085},[3252],{"type":42,"value":2127},{"type":36,"tag":513,"props":3254,"children":3255},{"style":520},[3256],{"type":42,"value":2132},{"type":36,"tag":513,"props":3258,"children":3259},{"class":515,"line":3039},[3260],{"type":36,"tag":513,"props":3261,"children":3262},{"style":854},[3263],{"type":42,"value":3264},"\u002F\u002F If user asks \"how long to get there?\", then add ETA\n",{"type":36,"tag":58,"props":3266,"children":3268},{"id":3267},"dont-set-limit-too-high-for-ui-display",[3269],{"type":42,"value":3270},"Don't: Set limit too high for UI display",{"type":36,"tag":501,"props":3272,"children":3274},{"className":2060,"code":3273,"language":2062,"meta":506,"style":506},"\u002F\u002F BAD - Overwhelming for simple dropdown\ncategory_search_tool({\n  category: 'restaurant',\n  limit: 25\n});\n\u002F\u002F Returns 25 restaurants for a 5-item dropdown\n\n\u002F\u002F GOOD - Match UI needs\ncategory_search_tool({\n  category: 'restaurant',\n  limit: 5\n});\n",[3275],{"type":36,"tag":509,"props":3276,"children":3277},{"__ignoreMap":506},[3278,3286,3301,3328,3345,3360,3368,3375,3383,3398,3425,3441],{"type":36,"tag":513,"props":3279,"children":3280},{"class":515,"line":516},[3281],{"type":36,"tag":513,"props":3282,"children":3283},{"style":854},[3284],{"type":42,"value":3285},"\u002F\u002F BAD - Overwhelming for simple dropdown\n",{"type":36,"tag":513,"props":3287,"children":3288},{"class":515,"line":526},[3289,3293,3297],{"type":36,"tag":513,"props":3290,"children":3291},{"style":2080},[3292],{"type":42,"value":287},{"type":36,"tag":513,"props":3294,"children":3295},{"style":2085},[3296],{"type":42,"value":2088},{"type":36,"tag":513,"props":3298,"children":3299},{"style":520},[3300],{"type":42,"value":523},{"type":36,"tag":513,"props":3302,"children":3303},{"class":515,"line":571},[3304,3308,3312,3316,3320,3324],{"type":36,"tag":513,"props":3305,"children":3306},{"style":2095},[3307],{"type":42,"value":2449},{"type":36,"tag":513,"props":3309,"children":3310},{"style":520},[3311],{"type":42,"value":548},{"type":36,"tag":513,"props":3313,"children":3314},{"style":520},[3315],{"type":42,"value":2107},{"type":36,"tag":513,"props":3317,"children":3318},{"style":556},[3319],{"type":42,"value":2395},{"type":36,"tag":513,"props":3321,"children":3322},{"style":520},[3323],{"type":42,"value":2117},{"type":36,"tag":513,"props":3325,"children":3326},{"style":520},[3327],{"type":42,"value":568},{"type":36,"tag":513,"props":3329,"children":3330},{"class":515,"line":597},[3331,3336,3340],{"type":36,"tag":513,"props":3332,"children":3333},{"style":2095},[3334],{"type":42,"value":3335},"  limit",{"type":36,"tag":513,"props":3337,"children":3338},{"style":520},[3339],{"type":42,"value":548},{"type":36,"tag":513,"props":3341,"children":3342},{"style":620},[3343],{"type":42,"value":3344}," 25\n",{"type":36,"tag":513,"props":3346,"children":3347},{"class":515,"line":630},[3348,3352,3356],{"type":36,"tag":513,"props":3349,"children":3350},{"style":520},[3351],{"type":42,"value":2536},{"type":36,"tag":513,"props":3353,"children":3354},{"style":2085},[3355],{"type":42,"value":2127},{"type":36,"tag":513,"props":3357,"children":3358},{"style":520},[3359],{"type":42,"value":2132},{"type":36,"tag":513,"props":3361,"children":3362},{"class":515,"line":656},[3363],{"type":36,"tag":513,"props":3364,"children":3365},{"style":854},[3366],{"type":42,"value":3367},"\u002F\u002F Returns 25 restaurants for a 5-item dropdown\n",{"type":36,"tag":513,"props":3369,"children":3370},{"class":515,"line":665},[3371],{"type":36,"tag":513,"props":3372,"children":3373},{"emptyLinePlaceholder":1708},[3374],{"type":42,"value":1711},{"type":36,"tag":513,"props":3376,"children":3377},{"class":515,"line":2530},[3378],{"type":36,"tag":513,"props":3379,"children":3380},{"style":854},[3381],{"type":42,"value":3382},"\u002F\u002F GOOD - Match UI needs\n",{"type":36,"tag":513,"props":3384,"children":3385},{"class":515,"line":2960},[3386,3390,3394],{"type":36,"tag":513,"props":3387,"children":3388},{"style":2080},[3389],{"type":42,"value":287},{"type":36,"tag":513,"props":3391,"children":3392},{"style":2085},[3393],{"type":42,"value":2088},{"type":36,"tag":513,"props":3395,"children":3396},{"style":520},[3397],{"type":42,"value":523},{"type":36,"tag":513,"props":3399,"children":3400},{"class":515,"line":24},[3401,3405,3409,3413,3417,3421],{"type":36,"tag":513,"props":3402,"children":3403},{"style":2095},[3404],{"type":42,"value":2449},{"type":36,"tag":513,"props":3406,"children":3407},{"style":520},[3408],{"type":42,"value":548},{"type":36,"tag":513,"props":3410,"children":3411},{"style":520},[3412],{"type":42,"value":2107},{"type":36,"tag":513,"props":3414,"children":3415},{"style":556},[3416],{"type":42,"value":2395},{"type":36,"tag":513,"props":3418,"children":3419},{"style":520},[3420],{"type":42,"value":2117},{"type":36,"tag":513,"props":3422,"children":3423},{"style":520},[3424],{"type":42,"value":568},{"type":36,"tag":513,"props":3426,"children":3427},{"class":515,"line":3039},[3428,3432,3436],{"type":36,"tag":513,"props":3429,"children":3430},{"style":2095},[3431],{"type":42,"value":3335},{"type":36,"tag":513,"props":3433,"children":3434},{"style":520},[3435],{"type":42,"value":548},{"type":36,"tag":513,"props":3437,"children":3438},{"style":620},[3439],{"type":42,"value":3440}," 5\n",{"type":36,"tag":513,"props":3442,"children":3444},{"class":515,"line":3443},12,[3445,3449,3453],{"type":36,"tag":513,"props":3446,"children":3447},{"style":520},[3448],{"type":42,"value":2536},{"type":36,"tag":513,"props":3450,"children":3451},{"style":2085},[3452],{"type":42,"value":2127},{"type":36,"tag":513,"props":3454,"children":3455},{"style":520},[3456],{"type":42,"value":2132},{"type":36,"tag":51,"props":3458,"children":3460},{"id":3459},"quick-reference",[3461],{"type":42,"value":3462},"Quick Reference",{"type":36,"tag":58,"props":3464,"children":3466},{"id":3465},"tool-selection-flowchart",[3467],{"type":42,"value":3468},"Tool Selection Flowchart",{"type":36,"tag":501,"props":3470,"children":3474},{"className":3471,"code":3473,"language":42},[3472],"language-text","User query contains...\n\n-> Specific name\u002Fbrand (Starbucks, Empire State Building)\n  -> search_and_geocode_tool\n\n-> Generic category\u002Fplural (coffee shops, museums, any restaurant)\n  -> category_search_tool\n\n-> Coordinates -> Address\n  -> reverse_geocode_tool\n\n-> Address -> Coordinates\n  -> search_and_geocode_tool with types: [\"address\"]\n",[3475],{"type":36,"tag":509,"props":3476,"children":3477},{"__ignoreMap":506},[3478],{"type":42,"value":3473},{"type":36,"tag":58,"props":3480,"children":3482},{"id":3481},"essential-parameters-checklist",[3483],{"type":42,"value":3484},"Essential Parameters Checklist",{"type":36,"tag":45,"props":3486,"children":3487},{},[3488],{"type":36,"tag":68,"props":3489,"children":3490},{},[3491],{"type":42,"value":3492},"For local searches, ALWAYS set:",{"type":36,"tag":84,"props":3494,"children":3495},{},[3496],{"type":36,"tag":88,"props":3497,"children":3498},{},[3499,3504],{"type":36,"tag":509,"props":3500,"children":3502},{"className":3501},[],[3503],{"type":42,"value":581},{"type":42,"value":3505}," (or bbox if strict boundary needed)",{"type":36,"tag":45,"props":3507,"children":3508},{},[3509],{"type":36,"tag":68,"props":3510,"children":3511},{},[3512],{"type":42,"value":3513},"For category searches, consider:",{"type":36,"tag":84,"props":3515,"children":3516},{},[3517,3528],{"type":36,"tag":88,"props":3518,"children":3519},{},[3520,3526],{"type":36,"tag":509,"props":3521,"children":3523},{"className":3522},[],[3524],{"type":42,"value":3525},"limit",{"type":42,"value":3527}," (match UI needs)",{"type":36,"tag":88,"props":3529,"children":3530},{},[3531,3537],{"type":36,"tag":509,"props":3532,"children":3534},{"className":3533},[],[3535],{"type":42,"value":3536},"format",{"type":42,"value":3538}," (json_string if plotting on map)",{"type":36,"tag":45,"props":3540,"children":3541},{},[3542],{"type":36,"tag":68,"props":3543,"children":3544},{},[3545],{"type":42,"value":3546},"For disambiguation, use:",{"type":36,"tag":84,"props":3548,"children":3549},{},[3550,3560],{"type":36,"tag":88,"props":3551,"children":3552},{},[3553,3558],{"type":36,"tag":509,"props":3554,"children":3556},{"className":3555},[],[3557],{"type":42,"value":997},{"type":42,"value":3559}," (when geographic context matters)",{"type":36,"tag":88,"props":3561,"children":3562},{},[3563,3568],{"type":36,"tag":509,"props":3564,"children":3566},{"className":3565},[],[3567],{"type":42,"value":1649},{"type":42,"value":3569}," (when feature type matters)",{"type":36,"tag":45,"props":3571,"children":3572},{},[3573],{"type":36,"tag":68,"props":3574,"children":3575},{},[3576],{"type":42,"value":3577},"For travel-time ranking:",{"type":36,"tag":84,"props":3579,"children":3580},{},[3581],{"type":36,"tag":88,"props":3582,"children":3583},{},[3584,3590,3592,3598,3599,3605],{"type":36,"tag":509,"props":3585,"children":3587},{"className":3586},[],[3588],{"type":42,"value":3589},"eta_type",{"type":42,"value":3591},", ",{"type":36,"tag":509,"props":3593,"children":3595},{"className":3594},[],[3596],{"type":42,"value":3597},"navigation_profile",{"type":42,"value":3591},{"type":36,"tag":509,"props":3600,"children":3602},{"className":3601},[],[3603],{"type":42,"value":3604},"origin",{"type":42,"value":3606}," (costs API quota)",{"type":36,"tag":51,"props":3608,"children":3610},{"id":3609},"common-mistakes",[3611],{"type":42,"value":3612},"Common Mistakes",{"type":36,"tag":3614,"props":3615,"children":3616},"ol",{},[3617,3627,3637,3647,3657,3667,3677,3687],{"type":36,"tag":88,"props":3618,"children":3619},{},[3620,3625],{"type":36,"tag":68,"props":3621,"children":3622},{},[3623],{"type":42,"value":3624},"Forgetting proximity",{"type":42,"value":3626}," -> Results are global\u002FIP-based (or wrong state for ambiguous memorial\u002Fpark names)",{"type":36,"tag":88,"props":3628,"children":3629},{},[3630,3635],{"type":36,"tag":68,"props":3631,"children":3632},{},[3633],{"type":42,"value":3634},"Using wrong tool",{"type":42,"value":3636}," -> category_search for \"Starbucks\" (use search_and_geocode)",{"type":36,"tag":88,"props":3638,"children":3639},{},[3640,3645],{"type":36,"tag":68,"props":3641,"children":3642},{},[3643],{"type":42,"value":3644},"Invalid category",{"type":42,"value":3646}," -> Check category_list first",{"type":36,"tag":88,"props":3648,"children":3649},{},[3650,3655],{"type":36,"tag":68,"props":3651,"children":3652},{},[3653],{"type":42,"value":3654},"Bbox too small",{"type":42,"value":3656}," -> No results; use proximity instead",{"type":36,"tag":88,"props":3658,"children":3659},{},[3660,3665],{"type":36,"tag":68,"props":3661,"children":3662},{},[3663],{"type":42,"value":3664},"Requesting ETA unnecessarily",{"type":42,"value":3666}," -> Adds API cost",{"type":36,"tag":88,"props":3668,"children":3669},{},[3670,3675],{"type":36,"tag":68,"props":3671,"children":3672},{},[3673],{"type":42,"value":3674},"Limit too high for UI",{"type":42,"value":3676}," -> Overwhelming user",{"type":36,"tag":88,"props":3678,"children":3679},{},[3680,3685],{"type":36,"tag":68,"props":3681,"children":3682},{},[3683],{"type":42,"value":3684},"Not filtering types",{"type":42,"value":3686}," -> Get cities when you want POIs",{"type":36,"tag":88,"props":3688,"children":3689},{},[3690,3695],{"type":36,"tag":68,"props":3691,"children":3692},{},[3693],{"type":42,"value":3694},"No debounce on typeahead",{"type":42,"value":3696}," -> Quota burn and racy UI",{"type":36,"tag":51,"props":3698,"children":3700},{"id":3699},"reference-files",[3701],{"type":42,"value":3702},"Reference Files",{"type":36,"tag":45,"props":3704,"children":3705},{},[3706],{"type":42,"value":3707},"Load these for deeper guidance on specific topics:",{"type":36,"tag":84,"props":3709,"children":3710},{},[3711,3725,3739],{"type":36,"tag":88,"props":3712,"children":3713},{},[3714,3723],{"type":36,"tag":68,"props":3715,"children":3716},{},[3717],{"type":36,"tag":509,"props":3718,"children":3720},{"className":3719},[],[3721],{"type":42,"value":3722},"references\u002Fadvanced-params.md",{"type":42,"value":3724}," — poi_category, ETA, format, and language parameters",{"type":36,"tag":88,"props":3726,"children":3727},{},[3728,3737],{"type":36,"tag":68,"props":3729,"children":3730},{},[3731],{"type":36,"tag":509,"props":3732,"children":3734},{"className":3733},[],[3735],{"type":42,"value":3736},"references\u002Fworkflows.md",{"type":42,"value":3738}," — Common patterns: Near Me, Branded, Geocoding, Category+Area, Reverse, Route-Based, Multilingual",{"type":36,"tag":88,"props":3740,"children":3741},{},[3742,3751],{"type":36,"tag":68,"props":3743,"children":3744},{},[3745],{"type":36,"tag":509,"props":3746,"children":3748},{"className":3747},[],[3749],{"type":42,"value":3750},"references\u002Foptimization-combining.md",{"type":42,"value":3752}," — Performance optimization, combining tools, handling no results, category list resource",{"type":36,"tag":3754,"props":3755,"children":3756},"style",{},[3757],{"type":42,"value":3758},"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":3760,"total":3932},[3761,3775,3792,3807,3829,3841,3855,3868,3882,3895,3910,3922],{"slug":3762,"name":3762,"fn":3763,"description":3764,"org":3765,"tags":3766,"stars":20,"repoUrl":21,"updatedAt":3774},"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},[3767,3770,3771],{"name":3768,"slug":3769,"type":13},"Android","android",{"name":9,"slug":8,"type":13},{"name":3772,"slug":3773,"type":13},"Mobile","mobile","2026-07-30T05:30:51.739352",{"slug":3776,"name":3776,"fn":3777,"description":3778,"org":3779,"tags":3780,"stars":20,"repoUrl":21,"updatedAt":3791},"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},[3781,3784,3787,3788],{"name":3782,"slug":3783,"type":13},"Branding","branding",{"name":3785,"slug":3786,"type":13},"Design","design",{"name":9,"slug":8,"type":13},{"name":3789,"slug":3790,"type":13},"Typography","typography","2026-04-06T18:28:41.2556",{"slug":3793,"name":3793,"fn":3794,"description":3795,"org":3796,"tags":3797,"stars":20,"repoUrl":21,"updatedAt":3806},"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},[3798,3801,3802,3803],{"name":3799,"slug":3800,"type":13},"Data Visualization","data-visualization",{"name":3785,"slug":3786,"type":13},{"name":9,"slug":8,"type":13},{"name":3804,"slug":3805,"type":13},"Performance","performance","2026-04-06T18:29:02.907655",{"slug":3808,"name":3808,"fn":3809,"description":3810,"org":3811,"tags":3812,"stars":20,"repoUrl":21,"updatedAt":3828},"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},[3813,3814,3817,3820,3823,3824,3825],{"name":3768,"slug":3769,"type":13},{"name":3815,"slug":3816,"type":13},"Dart","dart",{"name":3818,"slug":3819,"type":13},"Flutter","flutter",{"name":3821,"slug":3822,"type":13},"iOS","ios",{"name":9,"slug":8,"type":13},{"name":3772,"slug":3773,"type":13},{"name":3826,"slug":3827,"type":13},"SDK","sdk","2026-05-12T06:03:11.211517",{"slug":3830,"name":3830,"fn":3831,"description":3832,"org":3833,"tags":3834,"stars":20,"repoUrl":21,"updatedAt":3840},"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},[3835,3836,3837],{"name":9,"slug":8,"type":13},{"name":3804,"slug":3805,"type":13},{"name":3838,"slug":3839,"type":13},"Strategy","strategy","2026-07-30T05:30:52.766227",{"slug":3842,"name":3842,"fn":3843,"description":3844,"org":3845,"tags":3846,"stars":20,"repoUrl":21,"updatedAt":3854},"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},[3847,3848,3851],{"name":9,"slug":8,"type":13},{"name":3849,"slug":3850,"type":13},"Migration","migration",{"name":3852,"slug":3853,"type":13},"Web Development","web-development","2026-04-06T18:28:56.459496",{"slug":3856,"name":3856,"fn":3857,"description":3858,"org":3859,"tags":3860,"stars":20,"repoUrl":21,"updatedAt":3867},"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},[3861,3862,3863,3864],{"name":3821,"slug":3822,"type":13},{"name":9,"slug":8,"type":13},{"name":3772,"slug":3773,"type":13},{"name":3865,"slug":3866,"type":13},"Swift","swift","2026-07-30T05:30:54.75526",{"slug":3869,"name":3869,"fn":3870,"description":3871,"org":3872,"tags":3873,"stars":20,"repoUrl":21,"updatedAt":3881},"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},[3874,3877,3878],{"name":3875,"slug":3876,"type":13},"Data Quality","data-quality",{"name":9,"slug":8,"type":13},{"name":3879,"slug":3880,"type":13},"MCP","mcp","2026-04-15T05:01:44.248764",{"slug":3883,"name":3883,"fn":3884,"description":3885,"org":3886,"tags":3887,"stars":20,"repoUrl":21,"updatedAt":3894},"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},[3888,3891,3892,3893],{"name":3889,"slug":3890,"type":13},"Engineering","engineering",{"name":9,"slug":8,"type":13},{"name":3849,"slug":3850,"type":13},{"name":3852,"slug":3853,"type":13},"2026-04-06T18:28:51.531856",{"slug":3896,"name":3896,"fn":3897,"description":3898,"org":3899,"tags":3900,"stars":20,"repoUrl":21,"updatedAt":3909},"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},[3901,3904,3907,3908],{"name":3902,"slug":3903,"type":13},"Documentation","documentation",{"name":3905,"slug":3906,"type":13},"Local Development","local-development",{"name":9,"slug":8,"type":13},{"name":3879,"slug":3880,"type":13},"2026-04-06T18:28:53.790961",{"slug":3911,"name":3911,"fn":3912,"description":3913,"org":3914,"tags":3915,"stars":20,"repoUrl":21,"updatedAt":3921},"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},[3916,3919,3920],{"name":3917,"slug":3918,"type":13},"Architecture","architecture",{"name":9,"slug":8,"type":13},{"name":3879,"slug":3880,"type":13},"2026-04-06T18:28:55.164842",{"slug":3923,"name":3923,"fn":3924,"description":3925,"org":3926,"tags":3927,"stars":20,"repoUrl":21,"updatedAt":3931},"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},[3928,3929,3930],{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":15,"slug":16,"type":13},"2026-04-06T18:28:50.264933",19,{"items":3934,"total":3932},[3935,3941,3948,3955,3965,3971,3977],{"slug":3762,"name":3762,"fn":3763,"description":3764,"org":3936,"tags":3937,"stars":20,"repoUrl":21,"updatedAt":3774},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3938,3939,3940],{"name":3768,"slug":3769,"type":13},{"name":9,"slug":8,"type":13},{"name":3772,"slug":3773,"type":13},{"slug":3776,"name":3776,"fn":3777,"description":3778,"org":3942,"tags":3943,"stars":20,"repoUrl":21,"updatedAt":3791},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3944,3945,3946,3947],{"name":3782,"slug":3783,"type":13},{"name":3785,"slug":3786,"type":13},{"name":9,"slug":8,"type":13},{"name":3789,"slug":3790,"type":13},{"slug":3793,"name":3793,"fn":3794,"description":3795,"org":3949,"tags":3950,"stars":20,"repoUrl":21,"updatedAt":3806},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3951,3952,3953,3954],{"name":3799,"slug":3800,"type":13},{"name":3785,"slug":3786,"type":13},{"name":9,"slug":8,"type":13},{"name":3804,"slug":3805,"type":13},{"slug":3808,"name":3808,"fn":3809,"description":3810,"org":3956,"tags":3957,"stars":20,"repoUrl":21,"updatedAt":3828},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3958,3959,3960,3961,3962,3963,3964],{"name":3768,"slug":3769,"type":13},{"name":3815,"slug":3816,"type":13},{"name":3818,"slug":3819,"type":13},{"name":3821,"slug":3822,"type":13},{"name":9,"slug":8,"type":13},{"name":3772,"slug":3773,"type":13},{"name":3826,"slug":3827,"type":13},{"slug":3830,"name":3830,"fn":3831,"description":3832,"org":3966,"tags":3967,"stars":20,"repoUrl":21,"updatedAt":3840},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3968,3969,3970],{"name":9,"slug":8,"type":13},{"name":3804,"slug":3805,"type":13},{"name":3838,"slug":3839,"type":13},{"slug":3842,"name":3842,"fn":3843,"description":3844,"org":3972,"tags":3973,"stars":20,"repoUrl":21,"updatedAt":3854},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3974,3975,3976],{"name":9,"slug":8,"type":13},{"name":3849,"slug":3850,"type":13},{"name":3852,"slug":3853,"type":13},{"slug":3856,"name":3856,"fn":3857,"description":3858,"org":3978,"tags":3979,"stars":20,"repoUrl":21,"updatedAt":3867},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[3980,3981,3982,3983],{"name":3821,"slug":3822,"type":13},{"name":9,"slug":8,"type":13},{"name":3772,"slug":3773,"type":13},{"name":3865,"slug":3866,"type":13}]