ThinkGeo Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== ThinkGeo Cloud Map Raster Tiles ======

ThinkGeo Cloud Raster Tile serves raster map tiles through XYZ. Check out [[https://samples.thinkgeo.com/thinkgeo-cloud/maps/xyz/|ThinkGeo Cloud Raster Map Online Sample]] for a quick look.

===== RESTful APIs=====

* //**Try it Online**:// All the ThinkGeo Cloud RESTful APIs can be tested online following the instructions below: 
  *  Get a ThinkGeo Cloud Client Key. Check out [[https://wiki.thinkgeo.com/wiki/thinkgeo_cloud_client_keys_guideline|ThinkGeo Cloud Client Keys Guideline]] see how to apply one. It's free for 60 days.  
  *  //** **// Authorize with the key at the top of [[https://cloud.thinkgeo.com/help/|ThinkGeo Cloud APIs]] and you are then free to play with all the APIs online. 


//**ThinkGeo Cloud provides a RESTful API to consume the map tiles**://
<code html> 
<!-- Get one Raster Tile based on given parameters -->
HTTP GET 
https://cloud.thinkgeo.com/api/v1/maps/raster/{style}/x{resolution}/{srid}/{tileSize}/{tileZ}/{tileX}/{tileY}.{fileExtension}?apikey={key}</code>
//**Parameters**//
  *  //**style**//: The style for the requesting tile, available values are "light", "dark", "aerial", "hybrid" and "transparent-background"
  *  //**resolution**//: The resolution for the requesting tile. "X1" is available and "X2" will be supported soon. "X1" is good enough for a regular 96 dpi monitor while "X2" is good for high DPI display especially on Apple devices.  Behind the Scene, the server will create an 1024*1024 image to serve a 512*512 X2 tile. 
  *  //**srid**//:The SRID for the requesting tile, currently only "3857" (Spherical Mercator) is supported
  *  //**tileSize**//: The size of the requesting 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 zoomlevel with the entire world in one single tile, Zoom Level z has 4^z tiles for the entire world. The greater the z is, the lower the current zoomlevel is. 
  *  //**tileX**//: The X index (column index in the tiling matrix) of the requesting tile. It is within [0, 4^z) for zoomlevel z. 
  *  //**tileY**//: The Y index (row index in the tiling matrix) of the requesting tile. It is within [0, 4^z) for zoomlevel z. 
  *  //**fileExtension**//: The format of the requesting tile, "png" is available for light/dark/transparent-background styles, "jpeg" and "jpg" are available for aerial/hybrid styles. 
  *  //**apikey**//: the apikey. 

  *  //**Sample Request URI**//: [[https://cloud.thinkgeo.com/api/v1/maps/raster/light/x1/3857/512/0/0/0.png?apikey=mykey]] (watermark shows up as no keys are provided). 

  *  Hit //**Try it Out**// button below [[https://cloud.thinkgeo.com/help/#/MapsRasterTiles/GetMapsRasterTileByXyzV1|GetMapsRasterTileByXyz]] to test it online. 



===== Map Data Coverage=====
Map Suite Raster Tile Data has street tiles and aerial images tiles. 

  * **Street Tiles**<div>The data of streets tiles (//light / dark / transparent-background// ) mainly come from [[https://www.openstreetmap.org|Open Street Map]], and partially from [[https://www.naturalearthdata.com/|Natural Earth]], it covers the entire world. The tiles are scheduled to be updated every month.</div>
  * **Aerial Image Tiles**
    * The data for zoom level 0 ~ 11 comes from [[https://www.usgs.gov/land-resources/nli/landsat|LandSat]], it covers the entire world. 
    * The data for zoom level 12 ~ 19 comes from [[https://www.fsa.usda.gov/programs-and-services/aerial-photography/imagery-programs/naip-imagery/index|NAIP]] 2018. It covers the contiguous US (48 states). The tiles are scheduled to be updated every 2 years.


The data is for sale as a separate product, it can be consumed offline by Map Suite SDKs. Check out [[thinkgeo_offline_data_maps_streets|Maps Streets Offline Data]] and [[thinkgeo_offline_data_maps_imagery|Maps Imagery Offline Data]] for detail. 

===== Consume from Client Side =====

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

==== From JavaScript Library ====

[[https://openlayers.org/|OpenLayers]] and [[https://leafletjs.com/|Leaflet]] have built-in classes consuming the tiles through XYZ. Here is the code snippet in OpenLayers. 

<code javascript>
var lightLayer = new ol.layer.Tile({
  source: new ol.source.XYZ({
	urls: [
	  "https://cloud.thinkgeo.com/api/v1/maps/raster/light/x1/3857/512/{z}/{x}/{y}.png?apikey=yourkey",
	],
	tileSize: 512
  }),
  name: "lightLayerKey"
});
</code>

The sample code in LeafLet: 
<code javascript>
var lightLayer = L.tileLayer("https://cloud.thinkgeo.com/api/v1/maps/raster/light/x1/3857/512/{z}/{x}/{y}.png?apikey=yourkey");
</code>
Here is an [[https://samples.thinkgeo.com/thinkgeo-cloud/maps/xyz/|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: 
<code csharp>
// Setup the overlay
ThinkGeoCloudMapsOverlay thinkGeoMapsOverlay= new ThinkGeoCloudMapsOverlay("clientId", "clientSecret");
// or ThinkGeoCloudMapsOverlay thinkGeoMapsOverlay= new ThinkGeoCloudMapsOverlay("apiKey");
Map.Overlays.Add(thinkGeoMapsOverlay);
</code>

  * Sample code: [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForWinForms|ThinkGeoCloudMapsSample-WinForms]] for [[map_suite_desktop_for_winforms|Map Suite Desktop For WinForms]]
  * Sample code: [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForWpf|ThinkGeoCloudMapsSample-WPF]] for [[map_suite_desktop_for_wpf|Map Suite Desktop For WPF]]
  * Sample code: [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForWebForms|ThinkGeoCloudMapsSample-WebForms]] for [[map_suite_web_for_webforms|Map Suite Web For WebForms]]
  * Sample code: [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForMvc|ThinkGeoCloudMapsSample-MVC]] for [[map_suite_web_for_mvc|Map Suite Web For MVC]]
  * Sample code: [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForiOS|ThinkGeoCloudMapsSample-iOS]] for [[map_suite_mobile_for_ios|Map Suite Mobile For iOS]]
  * Sample code: [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForAndroid|ThinkGeoCloudMapsSample-Android]] for [[map_suite_mobile_for_android|Map Suite Mobile for Android]]



==== From Client Side SDKs ====

A .Net SDK //ThinkGeo Cloud Client// is provided to consume the ThinkGeo Cloud Service as well. It's available on [[https://www.nuget.org/packages/ThinkGeo.GisServer.Client|NuGet]], here is the complete [[thinkgeo_cloud_.net_client_apis|API List]]. 

Sample Code: 
<code csharp>
MapsClient client = new MapsClient("clientId", "clientSecret");
Stream imageStream = client.GetRasterTile(z, x, y, projection, mapType, tileSize, tileResolution);
Task<Stream> task = client.GetRasterTileAsync(z, x, y, projection, mapType, tileSize, tileResolution);
</code>

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

===== Samples =====

Online Sample:
  * [[https://samples.thinkgeo.com/thinkgeo-cloud/maps/xyz/|ThinkGeo Cloud Raster Map Online Sample]] 

Desktop Samples: 
  * [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForWinForms|ThinkGeoCloudMapsSample-WinForms]] for [[map_suite_desktop_for_winforms|Map Suite Desktop For WinForms]]
  * [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForWpf|ThinkGeoCloudMapsSample-WPF]] for [[map_suite_desktop_for_wpf|Map Suite Desktop For WPF]]

Web Samples: 
  * [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForiOS|ThinkGeoCloudMapsSample-iOS]] for [[map_suite_mobile_for_ios|Map Suite Mobile For iOS]]
  * [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForAndroid|ThinkGeoCloudMapsSample-Android]] for [[map_suite_mobile_for_android|Map Suite Mobile for Android]]

Mobile Samples: 
  * [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForWebForms|ThinkGeoCloudMapsSample-WebForms]] for [[map_suite_web_for_webforms|Map Suite Web For WebForms]]
  * [[https://github.com/ThinkGeo/ThinkGeoCloudMapsSample-ForMvc|ThinkGeoCloudMapsSample-MVC]] for [[map_suite_web_for_mvc|Map Suite Web For MVC]]

===== Related Links =====
  * [[thinkgeo_cloud_maps_wms|ThinkGeo Cloud Maps WMS]]
  * [[thinkgeo_cloud_maps_vector_tiles|ThinkGeo Cloud Maps Vector Tiles]]
  * [[thinkgeo_cloud_geocoding|ThinkGeo Cloud Geocoding]]
  * [[thinkgeo_cloud_reverse_geocoding|ThinkGeo Cloud Reverse Geocoding]]
  * [[thinkgeo_cloud_elevation|ThinkGeo Cloud Elevation]]
  * [[thinkgeo_cloud_projection|ThinkGeo Cloud Projection]]
  * [[thinkgeo_cloud_colors|ThinkGeo Cloud Colors]]
User Tools

Site Tools

Page Tools
