{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/guides/map/v1.0/styles-api","default":false,"active":false,"folderId":"419ebfde"},{"version":"latest","label":"Latest","link":"/guides/map/styles-api","default":true,"active":true,"folderId":"419ebfde"}],"sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Styles 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":"styles-api","__idx":0},"children":["Styles API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Digime Styles API"]}," serves map style documents used to render vector tiles in libraries like Mapbox GL JS and MapLibre GL JS."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A style is a JSON document that defines the visual appearance of a map: which sources to draw from, the layers to render, and how those layers are painted (colors, fonts, icons, and so on)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieve-a-style","__idx":1},"children":["Retrieve a style"]},{"$$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/styles/{style_name}.json?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":["style_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the name of the style. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#available-styles"},"children":["Available styles"]}," below."]}]},{"$$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":"Heading","attributes":{"level":3,"id":"available-styles","__idx":2},"children":["Available styles"]},{"$$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":"Style name"},"children":["Style name"]},{"$$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":["dgm_light"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DGM Light — the default light-themed basemap style."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["More styles will be added in the future."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-retrieve-a-style","__idx":3},"children":["Example request: Retrieve a style"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ curl \"https://dplace-api.themap.world/basemap/styles/dgm_light.json?apikey=YOUR_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-retrieve-a-style","__idx":4},"children":["Response: Retrieve a style"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response is a JSON document, following the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://maplibre.org/maplibre-style-spec/"},"children":["MapLibre Style Specification"]},", that can be passed directly to a compatible map rendering library, for example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"js","header":{"controls":{"copy":{}}},"source":"map = new maplibregl.Map({\n  container: \"map\",\n  style: \"https://dplace-api.themap.world/basemap/styles/dgm_light.json?apikey=YOUR_API_KEY\",\n  center: [106.700981, 10.775848],\n  zoom: 12,\n});\n","lang":"js"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"styles-api-errors","__idx":5},"children":["Styles 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":["Style {style_name} does not exist"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the name of the style you used in the query."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"styles-api-restrictions-and-limits","__idx":6},"children":["Styles API restrictions and limits"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The default rate limit for the Digime Styles 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 Styles API set default Cache-Control headers to ensure fast delivery across edge networks."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"styles-api-pricing","__idx":7},"children":["Styles 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 style requests in our pricing page's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Maps"]}," section."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Usage of the Styles API is measured in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["style requests"]},". Details about the number of style 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":"Styles API","id":"styles-api","depth":1},{"value":"Retrieve a style","id":"retrieve-a-style","depth":2},{"value":"Available styles","id":"available-styles","depth":3},{"value":"Example request: Retrieve a style","id":"example-request-retrieve-a-style","depth":3},{"value":"Response: Retrieve a style","id":"response-retrieve-a-style","depth":3},{"value":"Styles API errors","id":"styles-api-errors","depth":2},{"value":"Styles API restrictions and limits","id":"styles-api-restrictions-and-limits","depth":2},{"value":"Styles API pricing","id":"styles-api-pricing","depth":2}],"frontmatter":{"seo":{"title":"Styles API"}},"lastModified":"2026-09-14T02:09:43.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/map/styles-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}