FAQ
Frequently asked questions
Can't find what you are looking for? Email [email protected].
- How is the price calculated?
- You pick a tier for requests per hour and a tier for POIs, and the monthly price is the two tier prices added together. The smallest tier of each is free, so the Free plan gives you 50 requests per hour and 1,000 POIs at no cost.
- Are there limits on the Free plan?
- Each account can have one team on Free; to create another team, upgrade the first one. You also need a verified email address to create API keys.
- What counts as a request?
- Every call made with an API key counts toward your team's hourly quota, including calls that end in an error. A CSV import or a routing call counts as one request, however large. Calls rejected with a
429 because a limit is reached do not count. - What happens when I reach my request quota?
- Requests over your hourly quota get a
429 JSON error and a Retry-After header until the quota resets at the top of the next hour (UTC). Each team can also send at most a thirtieth of its hourly quota in any minute, never fewer than 20; over that, the 429 tells you how many seconds to wait. The X-RateLimit-* headers on every response let you see it coming. - Is there a limit on how many POIs I can store?
- Yes, every plan has a POI limit, 1,000 on Free. Once your team reaches it, creating more POIs is rejected until you delete some or move to a larger plan, and a running import stops at the limit and reports the rows it skipped.
- Can I import POIs in bulk?
- Yes. Upload a CSV with
name, latitude, longitude, an optional category and one column per attribute, from the dashboard or with POST /v1/imports. It is processed in the background, and every new POI is geocoded. - Can I plan routes with my POIs?
- Yes.
POST /v1/routes plans a route that keeps away from the POIs you select, /v1/routes/clusters groups stops into compact areas, and /v1/routes/optimize assigns stops to vehicles around time windows and capacities. The API key needs the plan-routes permission. Avoiding POIs and optimizing deliveries use a daily allowance of routing calls set by your requests tier, from 20 on Free to 1,000 on the largest tier; clustering is free. See the routing guides. - Where do the addresses come from?
- From OpenStreetMap, through Nominatim reverse geocoding. When you create a POI or change its coordinates, a background job fills in the street, display address, city, country and zipcode. Until then those fields are empty, and
geocoded_at tells you when it last ran. - What can I store on a POI?
- A name, coordinates, an optional category and any attributes your team defines. Attributes are typed as string, number or boolean, and you filter on them with
attributes[name]=value, using either the attribute name or its ID. - How far can a distance search reach?
- Up to 100 km. Pass
latitude, longitude and a distance in meters; if you leave the distance out it defaults to 1,000 m. Each result includes its distance from the point. - How does pagination work?
- List endpoints are cursor-paginated. Ask for 1 to 100 results with
limit (15 by default) and pass the next value from the response as cursor to get the following page. - How many people can join my team?
- Up to 2 on Free and 10 on any paid plan, pending invitations included. Members share the team's POIs, API keys and quotas, each with the role you give them.
- Is my data separate from other customers?
- Yes. POIs, attributes, categories and API keys all belong to a team, and a key can only ever reach the data of the team that created it.
- Is there an SDK?
- Not yet. Official SDKs for Laravel, Go and Node.js are coming soon. In the meantime the API is plain REST and JSON, so any HTTP client works. The docs have curl examples, and the API explorer lets you try every endpoint in the browser and download a Postman collection and an OpenAPI spec to generate a client from.
- How do I get a larger plan?
- Every account starts on Free. When you need more requests or more POIs, pick new tiers on the Plan & usage page of the dashboard and pay securely through Link, powered by Stripe. Prices exclude VAT, which is added at checkout where it applies. The new limits apply to your whole team right away and changes are prorated. You can cancel anytime and keep your limits until the end of the billing period. POI tiers above 250,000 are set up by agreement; for those, or anything beyond the largest tiers, email [email protected].