This shows you the differences between two versions of the page.
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]] | ||