{"uid":"cap_0mRfrKbdCzUzqBEed7Yqv","slug":"mapbox-tilequery-52fc2436","name":"Mapbox Tilequery","description":"Query vector tileset features near a geographic point. Useful for spatial lookups (e.g. \"what features are within 100m of this point?\").","url":"https://mapbox.mpp.paywithlocus.com/mapbox/tilequery?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["tileset_id","longitude","latitude"],"properties":{"limit":{"type":"number","description":"Max features to return (1-50, default 5)"},"dedupe":{"type":"boolean","description":"Remove duplicate features (default true)"},"layers":{"type":"string","description":"Comma-separated layer names to query"},"radius":{"type":"number","description":"Search radius in meters (default 0 for point-in-polygon)"},"geometry":{"type":"string","description":"Filter by geometry type: polygon, linestring, point"},"latitude":{"type":"number","description":"Latitude (-85 to 85)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"},"tileset_id":{"type":"string","description":"Tileset ID to query (e.g. \"mapbox.mapbox-streets-v8\"). Comma-separate up to 25."}},"additionalProperties":true},"responseSchema":null,"example":{"request":{"limit":5,"dedupe":true,"radius":50,"latitude":37.7749,"longitude":-122.4194,"tileset_id":"mapbox.mapbox-streets-v8"},"response":{"data":{"type":"FeatureCollection","features":[{"id":6769526911,"type":"Feature","geometry":{"type":"Point","coordinates":[-122.41938598752023,37.774892433901925]},"properties":{"len":750,"type":"sidewalk","class":"path","oneway":"false","surface":"paved","structure":"none","tilequery":{"layer":"road","distance":1.493073958255324,"geometry":"linestring"},"iso_3166_1":"US","iso_3166_2":"US-CA"}},{"id":14093479981,"type":"Feature","geometry":{"type":"Point","coordinates":[-122.41937085986137,37.77490837690999]},"properties":{"len":190,"type":"crossing","class":"path","oneway":"false","surface":"paved","structure":"none","tilequery":{"layer":"road","distance":2.7304866119949573,"geometry":"linestring"},"iso_3166_1":"US","iso_3166_2":"US-CA"}},{"id":0,"type":"Feature","geometry":{"type":"Point","coordinates":[-122.41941645741463,37.774921097392664]},"properties":{"house_num":"724","tilequery":{"layer":"housenum_label","distance":2.7541585840048417,"geometry":"point"},"iso_3166_1":"US","iso_3166_2":"US-CA"}},{"id":0,"type":"Feature","geometry":{"type":"Point","coordinates":[-122.41941377520561,37.77492427751298]},"properties":{"house_num":"88","tilequery":{"layer":"housenum_label","distance":2.955254358571551,"geometry":"point"},"iso_3166_1":"US","iso_3166_2":"US-CA"}},{"id":0,"type":"Feature","geometry":{"type":"Point","coordinates":[-122.4194124341011,37.774925337553086]},"properties":{"house_num":"1464","tilequery":{"layer":"housenum_label","distance":3.018043742674797,"geometry":"point"},"iso_3166_1":"US","iso_3166_2":"US-CA"}}]},"success":true}},"exampleRequest":{"limit":5,"dedupe":true,"radius":50,"latitude":37.7749,"longitude":-122.4194,"tileset_id":"mapbox.mapbox-streets-v8"},"tags":["maps","geocoding","directions","routing","geospatial","data"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZMx7qVzR8e-eneNVU4gWy","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"Mapbox","brandSlug":"mapbox","brandBaseUrl":"https://www.mapbox.com","brandDocsUrl":"https://docs.mapbox.com/api/","whatItDoes":"Query geographic features from a Mapbox tileset at a specific longitude/latitude point, returning nearby features with distance and geometry metadata.","exampleAgentPrompt":"Using the Mapbox Streets tileset (mapbox.mapbox-streets-v8), what road and path features are within 50 meters of coordinates -122.4194 longitude, 37.7749 latitude? Return up to 5 results with deduplication enabled.","exampleUseCases":[{"title":"Check local road surface quality","prompt":"I'm at coordinates 40.7128 latitude, -74.0060 longitude in Manhattan. What roads and surfaces are immediately around me according to Mapbox Streets? I want to know if it's a highway, local street, or path, and what the surface type is."},{"title":"Identify land parcels at address","prompt":"I have a property location at latitude 51.5074, longitude -0.1278 in London. Query the Mapbox tileset to find what land use features and administrative boundaries contain this point. Show me up to 10 results with the feature types and classes."},{"title":"Find nearby points of interest","prompt":"My customer is at latitude 34.0522, longitude -118.2437 near Los Angeles. Using Mapbox Streets, what POI features, buildings, and landmarks are within 100 meters of that spot? Include the distance from their exact location for each result."}],"resultDescription":"A GeoJSON FeatureCollection with up to N matched features, each including geometry (point coordinates), properties (feature type, class, surface, oneway, structure, ISO country codes), and a tilequery metadata block showing the originating layer, distance from the query point in meters, and the geometry type of the matched feature.","failureModes":["Invalid tileset_id returns 404 or empty FeatureCollection","Latitude outside -85 to 85 range returns validation error","Longitude outside -180 to 180 range returns validation error","Limit outside 1-50 range returns validation error","Invalid geometry filter value returns 422","Querying a private tileset without proper access returns 401/403","No features found within radius returns empty features array"],"whenToPreferThis":"Use Tilequery when you need to retrieve vector tile features at or near a specific coordinate from a Mapbox tileset — especially for point-in-polygon checks, nearby road/feature lookups, or enriching a location with layer-specific geographic attributes. Prefer this over forward/reverse geocoding when you need raw tileset feature data (e.g., road class, surface type, custom layer attributes) rather than human-readable addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:31:58.280Z","isFirstParty":false,"canonicalSlug":"mapbox-tilequery-52fc2436"}