These are the docs for the Metabase master branch. Some features documented here may not yet be available in the latest release. Check out the docs for the latest version, Metabase v0.50.


/api/tiles endpoints.

GET /api/tiles/:zoom/:x/:y/:lat-field/:lon-field

This endpoints provides an image with the appropriate pins rendered given a MBQL query (passed as a GET query string param). We evaluate the query and find the set of lat/lon pairs which are relevant and then render the appropriate ones. It’s expected that to render a full map view several calls will be made to this endpoint in parallel.


  • zoom value must be an integer.

  • x value must be an integer.

  • y value must be an integer.

  • lat-field string

  • lon-field string

  • query value must be a valid JSON string.

« Back to API index

Read docs for other versions of Metabase.

Thanks for your feedback!

Want to improve these docs? Propose a change.