User Tools

Site Tools


thinkgeo_cloud_maps_raster_tiles

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
thinkgeo_cloud_maps_raster_tiles [2019/03/11 16:45]
brianr [From Client Side SDKs]
thinkgeo_cloud_maps_raster_tiles [2019/03/31 16:38] (current)
brianr [Related Links]
Line 19: Line 19:
 https://​cloud.thinkgeo.com/​api/​v1/​maps/​raster/​{style}/​x{resolution}/​{srid}/​{tileSize}/​{tileZ}/​{tileX}/​{tileY}.{fileExtension}?​apikey={key}</​code>​ https://​cloud.thinkgeo.com/​api/​v1/​maps/​raster/​{style}/​x{resolution}/​{srid}/​{tileSize}/​{tileZ}/​{tileX}/​{tileY}.{fileExtension}?​apikey={key}</​code>​
 //**URL Parameters**//​ //**URL Parameters**//​
-  *  //**style**//: The style of the raster tile. Available values are: +  * <​html><​span class="​api-parameter"><​span class="​api-parameter-name">​style:</​span> ​The style of the raster tile. Available values are:</​span></​html>​ 
-     ​* ​//**light**// - street map, light theme +     ​* ​<​html><​span class="​api-parameter"><​span class="​api-parameter-name">​light</span> ​- street map, light theme</​span></​html>​ 
-     ​* ​//**dark**// - street map, dark theme +     ​* ​<​html><​span class="​api-parameter"><​span class="​api-parameter-name">​dark</span> ​- street map, dark theme</span><​/html> 
-     ​* ​//**aerial**// - aerial imagery +     <​html><​span class="​api-parameter"><​span class="​api-parameter-name">​aerial</span> ​- aerial imagery</​span></​html>​ 
-     ​* ​//**hybrid**// - aerial imagery with street map overlaid on top +     ​* ​<​html><​span class="​api-parameter"><​span class="​api-parameter-name">​hybrid</span> ​- aerial imagery with street map overlaid on top</​span></​html>​ 
-     ​* ​//**transparent-background**// - street map with transparent background +     ​* ​<​html><​span class="​api-parameter"><​span class="​api-parameter-name">​transparent-background</span> ​- street map with transparent background</​span></​html>​ 
-  *  //**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.  ​Currently, "​x2"​ is supported for the following raster tile types, with wider support currently being developed:​ +  * <​html><​span class="​api-parameter"><​span class="​api-parameter-name">​resolution:</​span> ​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.  ​</span><​/html> 
-     * Style: //light// or //dark// +  * <​html><​span class="​api-parameter"><​span class="​api-parameter-name">​srid:</​span> ​The spatial reference system ID for the raster tile.  Currently only "​3857"​ (Spherical Mercator) is supported.</span><​/html> 
-     * TileSize: 512 +  ​<​html><​span class="​api-parameter"><​span class="​api-parameter-name">​tileSize:</​span> ​The pixel size of the raster tile. "​512"​ is recommended. "​256"​ is also supported.</​span></​html>​ 
-  *  //**srid**//: The spatial reference system ID for the raster tile.  Currently only "​3857"​ (Spherical Mercator) is supported. +  * <​html><​span class="​api-parameter"><​span class="​api-parameter-name">​tileZ:</​span> ​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 <em>z</em> ​has 4<​sup>​<em>z</em></​sup>​ tiles for the entire world. The greater the z value, the closer to the Earth'​s surface the current zoom level is.</​span></​html>​ 
-  *  ​//**tileSize**//: The pixel size of the raster tile. "​512"​ is recommended. "​256"​ is also supported.  +  * <​html><​span class="​api-parameter"><​span class="​api-parameter-name">​tileX:</​span> ​The X index (column index in the tiling matrix) of the requesting tile. Valid range is between 0 and 4<​sup>​<em>z</em></​sup>​ for each given zoom level <em>z</em>.</​span></​html>​ 
-  *  //**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 4<​sup>​//z//</​sup>​ tiles for the entire world. The greater the z value, the closer to the Earth'​s surface the current zoom level is.  +  * <​html><​span class="​api-parameter"><​span class="​api-parameter-name">​tileY:</​span> ​The Y index (row index in the tiling matrix) of the requesting tile. Valid range is between 0 and 4<​sup>​<em>z</em></​sup>​ for each given zoom level <em>z</em>.</span><​/html> 
-  *  //**tileX**//: The X index (column index in the tiling matrix) of the requesting tile. Valid range is between 0 and 4<​sup>​//z//</​sup>​ for each given zoom level //z//.  +  ​<​html><​span class="​api-parameter"><​span class="​api-parameter-name">​fileExtension:​</​span> ​The image format of the raster tile.  Different formats are available depending on the tile style you have requested, as follows:</​span></​html>​ 
-  *  //**tileY**//: The Y index (row index in the tiling matrix) of the requesting tile. Valid range is between 0 and 4<​sup>​//z//</​sup>​ for each given zoom level //z// +     ​* ​<​html><​span class="​api-parameter"><​span class="​api-parameter-name">​png</span> ​- supported for <em>light</em><em>dark</em>, and <em>transparent-background</em> ​style tiles.</​span></​html>​ 
-  *  ​//**fileExtension**//: The image format of the raster tile.  Different formats are available depending on the tile style you have requested, as follows: +     ​* ​<​html><​span class="​api-parameter"><​span class="​api-parameter-name">​jpeg</span> ​or <span class="​api-parameter-name">​jpg</span> ​- supported for <em>aerial</em> ​and <em>hybrid</em> ​style tiles.</​span></​html>​ 
-     ​* ​//**png**// - supported for //light////dark//, and //transparent-background/​style tiles. +  * <​html><​span class="​api-parameter"><​span class="​api-parameter-name">​apikey:</​span> ​The ThinkGeo Cloud API key that authenticates your request.</​span></​html>​
-     ​* ​//**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: [[https://​cloud.thinkgeo.com/​api/​v1/​maps/​raster/​light/​x1/​3857/​512/​0/​0/​0.png]]. ​ 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 [[thinkgeo_cloud_client_keys_guideline|Client Keys Guideline]] to find out how to get your own API key. Here is an example of a raster tile request URL: [[https://​cloud.thinkgeo.com/​api/​v1/​maps/​raster/​light/​x1/​3857/​512/​0/​0/​0.png]]. ​ 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 [[thinkgeo_cloud_client_keys_guideline|Client Keys Guideline]] to find out how to get your own API key.
Line 102: Line 100:
  
  
-==== From Client Side SDKs ====+==== 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 [[https://​www.nuget.org/​packages/​ThinkGeo.Cloud.Client|NuGet]]. ​ IntelliSense hints will help you get started, and you can also refer to the [[thinkgeo_cloud_.net_client_apis|ThinkGeo Cloud Client API list]] for details. Our .NET SDK //ThinkGeo Cloud Client// makes it easy to consume all of the ThinkGeo Cloud services in your applications. It's available on [[https://​www.nuget.org/​packages/​ThinkGeo.Cloud.Client|NuGet]]. ​ IntelliSense hints will help you get started, and you can also refer to the [[thinkgeo_cloud_.net_client_apis|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 [[https://​github.com/​ThinkGeo?​utf8=%E2%9C%93&​q=cloud&​type=&​language=|samples utilizing the ThinkGeo Cloud Client]].
  
 Sample Code:  Sample Code: 
Line 142: Line 142:
   * [[thinkgeo_cloud_projection|ThinkGeo Cloud Projection]]   * [[thinkgeo_cloud_projection|ThinkGeo Cloud Projection]]
   * [[thinkgeo_cloud_colors|ThinkGeo Cloud Colors]]   * [[thinkgeo_cloud_colors|ThinkGeo Cloud Colors]]
 +  * [[thinkgeo_cloud_timezone|ThinkGeo Cloud Time Zones]]
  
thinkgeo_cloud_maps_raster_tiles.1552322709.txt.gz · Last modified: 2019/03/11 16:45 by brianr