User Tools

Site Tools


ThinkGeo Cloud Map Raster Tiles

ThinkGeo Cloud Raster Tile serves raster map tiles through XYZ. Check out ThinkGeo Cloud Raster Map Online Sample for a quick look.


* Try it Online: All the ThinkGeo Cloud RESTful APIs can be tested online following the instructions below:

ThinkGeo Cloud provides a RESTful API to consume the map tiles:

Get Maps Raster Tile By XYZ

Get the raster tile at the specified zoom level and X/Y coordinate, using the supplied parameters.

HTTP GET{style}/x{resolution}/{srid}/{tileSize}/{tileZ}/{tileX}/{tileY}.{fileExtension}?apikey={key}

URL Parameters

  • style: The style of the raster tile. Available values are:
    • light - street map, light theme
    • dark - street map, dark theme
    • aerial - aerial imagery
    • hybrid - aerial imagery with street map overlaid on top
    • transparent-background - street map with transparent background
  • resolution: The resolution of the raster tile. "x1" is available for all sizes, while "x2" is supported in certain scenarios. "x1" is intended for display on a regular 72-96 DPI laptop or desktop monitor, while "x2" is for high-DPI displays such as mobile phones and tablets. When you request an "x2" tile, the server will double the size of the image while rendering the same geographic area. So if you request an "x2" tile at size 512, the server will return you a 1024x1024 image.
  • srid: The spatial reference system ID for the raster tile. Currently only "3857" (Spherical Mercator) is supported.
  • tileSize: The pixel size of the raster tile. "512" is recommended. "256" is also supported.
  • tileZ: The Z index (zoom level) of the requesting tile, from 0 to 19. Zoom Level 0 is the highest zoom level with the entire world in one single tile. Each zoom level z has 4z tiles for the entire world. The greater the z value, the closer to the Earth's surface the current zoom level is.
  • tileX: The X index (column index in the tiling matrix) of the requesting tile. Valid range is between 0 and 4z for each given zoom level z.
  • tileY: The Y index (row index in the tiling matrix) of the requesting tile. Valid range is between 0 and 4z for each given zoom level z.
  • fileExtension: The image format of the raster tile. Different formats are available depending on the tile style you have requested, as follows:
    • png - supported for light, dark, and transparent-background style tiles.
    • jpeg or jpg - supported for aerial and hybrid style tiles.
  • apikey: The ThinkGeo Cloud API key that authenticates your request.

Here is an example of a raster tile request URL: When no API key is specified, the tile will be watermarked with a ThinkGeo logo. To remove the watermark, a valid ThinkGeo Cloud API key is required. Please check out Client Keys Guideline to find out how to get your own API key.

Visit GetMapsRasterTileByXyz and click “Try It Out” to explore this API online.

Map Data Coverage

Map Suite Raster Tile Data is composed of street tiles and aerial images tiles.

  • Street Tiles

    The data of streets tiles (light / dark / transparent-background ) mainly come from Open Street Map, and partially from Natural Earth. The tiles cover the entire world. The tiles are scheduled to be updated on a monthly basis.

  • Aerial Image Tiles
    • The data for zoom level 0 ~ 11 comes from LandSat, it covers the entire world.
    • The data for zoom level 12 ~ 19 comes from NAIP 2018. It covers the contiguous US (48 states). The tiles are scheduled to be updated every 2 years.

Our World Map data can be purchased separately. It can be consumed offline by Map Suite SDKs. Check out Maps Streets Offline Data and Maps Imagery Offline Data for detail.

Consume from Client Side

Multiple ways are provided to consume the server from different platforms.

From JavaScript Library

OpenLayers and Leaflet have built-in classes consuming the tiles through XYZ. Here is the code snippet in OpenLayers.

var lightLayer = new ol.layer.Tile({
  source: new ol.source.XYZ({
	urls: [
	tileSize: 512
  name: "lightLayerKey"

The sample code in LeafLet:

var lightLayer = L.tileLayer("{z}/{x}/{y}.png?apikey=yourkey");

Here is an Online Sample consuming the map tiles using OpenLayers.

From Map Suite UI Controls

All of the MapSuite UI Controls have built-in a straightforward way for consuming the raster tiles.

Sample Code:

using ThinkGeo.Cloud;
// Setup the overlay
ThinkGeoCloudMapsOverlay thinkGeoMapsOverlay = new ThinkGeoCloudMapsOverlay("Your Client ID", "Your Client Secret");
// or ThinkGeoCloudMapsOverlay thinkGeoMapsOverlay= new ThinkGeoCloudMapsOverlay("Your apiKey");

Consume From Client Side SDKs

Our .NET SDK ThinkGeo Cloud Client makes it easy to consume all of the ThinkGeo Cloud services in your applications. It's available on NuGet. IntelliSense hints will help you get started, and you can also refer to the ThinkGeo Cloud Client API list for details.

At the NuGet Package Manager terminal, you can install this package by running the command: Install-Package ThinkGeo.Cloud.Client -Version VERSION_TO_BE_INSTALLED. You can also check out ThinkGeo on GitHub for samples utilizing the ThinkGeo Cloud Client.

Sample Code:

using ThinkGeo.Cloud;
MapsClient client = new MapsClient("Your Client ID", "Your Client Secret");
Stream imageStream = client.GetRasterTile(z, x, y, projection, mapType, tileSize, tileResolution);

Native SDKs for Python, iOS and Android are coming soon.


thinkgeo_cloud_maps_raster_tiles.txt · Last modified: 2019/03/31 16:38 by brianr