CreateMaps REST API Test

How to use this API explorer

This page sends real CreateMaps REST requests. Use it to learn the API, copy curl examples, preview vector tiles, and generate a minimal MapLibre embed.

Load one of the examples, or edit the query and view fields.
Click a workflow such as Prepare -> Tile, Search -> Resolve, or Query -> GeoJSON.
Open Request Example to copy the exact HTTP request for your own code.
After Prepare, click Embed HTML for a minimal MapLibre page.

Embed a map

POST /v1/queries/prepare returns styleUrl. Load that URL in MapLibre GL JS or MapLibre Native.

Search and show a result

POST /v1/search returns lightweight hits. Resolve one previewToken only when geometry is needed.

Export data

POST /v1/query.geojson or /query.csv runs a PBFX query and returns user-facing result data.

Route

GET /v1/route-profiles lists profiles. POST /v1/route calculates a route with the selected profile.

Natural language actions

POST /v1/nl/execute translates and directly runs pure geocode or route requests such as routeOnly(...).

Do not paste confidential data. Requests, outputs, and feedback context may be logged during alpha testing. The generated curl request is the most precise example for each endpoint. See Alpha Terms, Privacy, and Data & copyright.

Load Example

GeoJSON is for data export. Count is a table-style aggregation. Coverage is the visual density-map example.

Minimal Integration

MapLibreCall POST /v1/queries/prepare, read styleUrl, then pass that URL as the MapLibre style.

Search UICall POST /v1/search while typing. Resolve only the selected previewToken.

ExportCall POST /v1/query.geojson or /query.csv with a coordinate-producing query.

Endpoint Cheat Sheet

prepareCreate vector-tile session, style URL, query hash, and preview metadata.

tilesRead MVT tiles for the latest prepared query hash.

queryRun raw PBFX query, including count and coverage outputs.

geojson/csvExport coordinate-producing queries in common data formats.

searchGeocode text with context; resolve only selected hits.

routeCalculate dynamic routes with server route profiles or custom profile text.

Connection

Workflows

Runs typical API sequences with the current input fields.

Query

Query Text

West South East North

Zoom Request ID

Prepare adds `vectorTiles` server-side. GeoJSON/CSV remove `vectorTiles` and add `limitLocal` when needed. Raw Query is sent unchanged.

Tile And Pick

Z X Y Query ID

Tile uses the latest prepared `queryHash`. Pick uses the bounds fields as click tolerance and the latest prepared `queryId`.

Text Context Zoom

Context Lat Context Lon

Resolve uses the `previewToken` from the first search hit and returns its GeoJSON geometry.

Natural Language

Prompt

Model Endpoint

`/nl/execute` runs pure actions such as `geocodeOnly(...)` and `routeOnly(...)`. It uses the Search context as geocoder context and GPS fallback for route-only examples.

Route

From Lon From Lat To Lon To Lat

Profile Profile Text

Query ID -

Query Hash -

Terrain Hash -

Last Bytes -

Ready

Start here: load an example, run a workflow, then copy the generated request.

Prepare returns styleUrl Search returns previewToken GeoJSON is data export

Request Example

Choose an API request on the left.

Map preview appears after Prepare.

no preview

Output

Choose an API request on the left.