{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/guides/map/v1.0/raster-tiles-api","default":false,"active":false,"folderId":"419ebfde"},{"version":"latest","label":"Latest","link":"/guides/map/raster-tiles-api","default":true,"active":true,"folderId":"419ebfde"}],"sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Raster Tiles API","description":"Digime Map is the groundbreaking API that allows you to search places, navigate between points, highlight street attributes and raster tile.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"raster-tiles-api","__idx":0},"children":["Raster Tiles API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Digime Raster Tiles API"]}," serves raster tiles generated from satellite imagery and raster data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tiles served from the Raster Tiles API can be consumed in any spatial application that supports image-based tilesets, including frontend mapping libraries like Mapbox GL JS, Leaflet, OpenLayers, as well as GIS software like QGIS."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieve-raster-tiles","__idx":1},"children":["Retrieve raster tiles"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET"]}," : ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://dplace-api.themap.world/basemap/raster-tiles/{map_type}/{zoom}/{x}/{y}{@2x}.png?apikey={YOUR_API_KEY}"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required parameters"},"children":["Required parameters"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["map_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the map type. For example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["roadmap"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zoom"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["integer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the tile's zoom level (supported from 0 to 20), as described in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://wiki.openstreetmap.org/wiki/Slippy_map_tilenames"},"children":["Slippy Map Tilenames"]}," specification."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{x}/{y}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["integer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the tile's column ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{x}"]}," and row ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{y}"]},", as described in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://wiki.openstreetmap.org/wiki/Slippy_map_tilenames"},"children":["Slippy Map Tilenames"]}," specification."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apikey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A valid Digime API key passed as a query parameter."]}]}]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Optional parameters"},"children":["Optional parameters"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@2x"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request a higher DPI version of the image for high-density displays."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-retrieve-raster-tiles","__idx":2},"children":["Example request: Retrieve raster tiles"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Retrieve a standard tile\n$ curl \"https://dplace-api.themap.world/basemap/raster-tiles/roadmap/9/407/240.png?apikey=YOUR_API_KEY\"\n\n# Retrieve a 2x tile; this tile is appropriate for high-density displays\n$ curl \"https://dplace-api.themap.world/basemap/raster-tiles/roadmap/9/407/240@2x.png?apikey=YOUR_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-retrieve-raster-tiles","__idx":3},"children":["Response: Retrieve raster tiles"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response is a raster image tile in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".png"]}," format. For performance, image tiles are delivered with caching headers set to optimize subsequent requests."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"raster-tiles-api-errors","__idx":4},"children":["Raster Tiles API errors"]},{"$$mdtype":"Tag","name":"table","attributes":{},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Response body ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["HTTP status code"]},{"$$mdtype":"Tag","name":"th","attributes":{},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Not Authorized - No Token"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No API key was used in the query."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Not Authorized - Invalid Token"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the API key you used in the query."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Forbidden"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There may be an issue with your account, or the API key has restrictions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tile not found"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the column and row of the tile requested in the query."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Zoom level must be between 0-20."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The zoom level specified in the query is larger than 20 or contains non-numeric characters."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"raster-tiles-api-restrictions-and-limits","__idx":5},"children":["Raster Tiles API restrictions and limits"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The default rate limit for the Digime Raster Tiles API endpoint depends on your current pricing plan. If you require a higher rate limit, please contact our sales team."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you exceed the rate limit, you will receive an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HTTP 429 Too Many Requests"]}," response."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Responses from the Raster Tiles API set default Cache-Control headers to ensure fast delivery across edge networks."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For general information on caching and tile performance, refer to our advanced integration guides."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"raster-tiles-api-pricing","__idx":6},"children":["Raster Tiles API pricing"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Billed by ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["requests"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["See rates and discounts per tile requests in our pricing page's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Maps"]}," section."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Usage of the Raster Tiles API is measured in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tile requests"]},". Details about the number of tile requests included in the free tier and the cost per request beyond what is included in the free tier are available on the pricing page."]}]},"headings":[{"value":"Raster Tiles API","id":"raster-tiles-api","depth":1},{"value":"Retrieve raster tiles","id":"retrieve-raster-tiles","depth":2},{"value":"Example request: Retrieve raster tiles","id":"example-request-retrieve-raster-tiles","depth":3},{"value":"Response: Retrieve raster tiles","id":"response-retrieve-raster-tiles","depth":3},{"value":"Raster Tiles API errors","id":"raster-tiles-api-errors","depth":2},{"value":"Raster Tiles API restrictions and limits","id":"raster-tiles-api-restrictions-and-limits","depth":2},{"value":"Raster Tiles API pricing","id":"raster-tiles-api-pricing","depth":2}],"frontmatter":{"seo":{"title":"Raster Tiles API"}},"lastModified":"2026-09-14T02:09:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/map/raster-tiles-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}