MTS Tiles

overview the mts maps apis provide capabilities to manage third party map service providers, render interactive maps and generate map tiles this guide covers integrating and using these key mapping features for developers to integrate into their applications key features map service provider management add and manage third party map providers store provider credentials securely using secure data storage (sds) seamlessly switch between providers mts tiles service display interactive maps using map image tiles customize tile layers based on zoom level and location integrate popular providers like mapbox, mapmyindia, etc how it works map provider configuration the mts service allows configuring and integrating third party mapping providers, including google , mapbox , mapmyindia , and heremaps , to render interactive maps tenants can register mapping providers at the tenant level by submitting a configuration request this request specifies provider details like name, type, and credentials activating a provider requires entering credentials like api keys these credentials are securely stored using the sds (secret data storage) service after activation, the provider integration status changes to "active," making it available mts apis use the active mapping providers for rendering maps and related functionality calls are routed to the appropriate provider based on configuration map tiles mts uses the concept of map image tiles to render interactive maps map tiles are small, square image files representing a part of the map at different zoom levels tiles are arranged in a grid system based on an (x, y) coordinate system for each zoom level the zoom level indicates the level of detail higher zoom levels show more detailed views the mts tiles api allows retrieving a tile image by specifying the tile's x and y coordinates and desired zoom level in the request the api endpoint determines the active map provider for the tenant based on configuration and fetches the tile from this provider overview of zoom levels (z), x, and y coordinates when working with map tiles in web mapping applications, it's important to understand the relationship between zoom levels (z) and the x and y coordinates these parameters define which specific part of the map is displayed and at what level of detail definition the zoom level (z) parameter in a map tile api specifies the map's level of detail or scale range typically, zoom levels range from 0 (the entire world on a single map tile) to higher values (more detailed views) for example, at zoom level 1, the world is divided into four tiles (2x2 grid) usage the higher the zoom level, the more tiles are needed to cover the same area with more detail x coordinate represents the column number of the tile within the grid at the specified zoom level y coordinate represents the row number of the tile within the grid at the same zoom level calculation both x and y coordinates are calculated based on the zoom level at zoom level 0, there's only one tile (0,0) at zoom level 1, x and y can be 0 or 1, forming a 2x2 grid, and so on permissible values the permissible values for x and y depend directly on the zoom level z as z increases, the range of x and y values increases exponentially for instance, at zoom level 2 (z=2), the world is divided into a 4x4 grid, so x and y can range from 0 to 3 refer to the azure maps documentation to learn about zoom levels, x and y coordinates, and how they form the tile grid it's a useful resource for developers who want to understand how to request and manipulate map data based on these parameters apis map service provider management apis registermapproviders registers a new map provider configuration getmapproviders get list of configured map providers getmapproviderbyname get details of a specific map provider updatemapprovider update configuration of a specific map provider deletemapprovider delete a specific map provider configuration note that this is hard deletion map tiles apis getmaptiles get a map image tile by specifying x, y coordinates and zoom level integration flow integrating the mts maps service into your application involves registering your map provider and retrieving map tiles follow the steps below for a detailed walkthrough step 1 register map service providers first, you need to register the third party map provider that will be used as the source of maps/tiles call the registermapproviders api to configure a provider view the request parameters below parameter type description name string unique name of the map provider integration type string 3rd party provider name should be oneof \["google", "mapbox", "mapmyindia", "heremaps"] credentials object contains the credentials for the map provider credentials apikey string base64 encoded apikey of the specific provider app developers can create an sds vault and configuration using sds id they can store keys in sds and view them later sample request create service provider { "name" "mygooglemapprovider", "type" "google", "credentials" { "apikey" "your base64 encoded api key" } } in this sample name is set to mygooglemapprovider , which is a placeholder for the unique name you would assign to your map provider integration type is set to google credentials contains an apikey field, where your base64 encoded api key should be replaced with the actual base64 encoded api key provided by your map service provider step 2 get map tile after successfully registering the map provider, you can start retrieving map tiles by calling the getmaptiles api view the path and query parameter below path parameters parameter type description z string denotes the zoom level of the map tile x string denotes the x coordinate y string denotes the y coordinate providername string denotes the map provider type default is "maptiler" for india tenants and "osm" for us tenants query parameters parameter type description providername string denotes the map provider type default is "maptiler" for india tenants and "osm" for us tenants in this example, the v1/mts/maps/tiles/3/5/3 request responds with the requested map tile for the indian subcontinent