The following tables describe the required and optional parameters you can use to make your raster tile map requests:
See example URLs for raster tile requests using these parameters.
| Raster Tile Info (actn=getTileInfo) Obtains raster tile data source information | ||
|---|---|---|
|
Parameter |
Description |
Valid Values |
|
tkn |
Authentication token returned from a getToken request |
Returned string from getToken request. Average length of string is 72–80 characters. Recommended authentication method. |
|
usrid |
Authentication returned from a getUserID request |
Returned string from getUserID request. Average length of string is 50–70 characters. To enable and disable UserIDs, visit the ArcWeb UserID account page. ESRI recommends using UserIDs only during phases development and testing, when they offer more flexibility and convenience. ESRI recommends that you change your account password, which invalidates any existing UserIDs, and switch to using tokens before making an application public. |
|
ds |
Data source |
Valid values are |
| Raster Tile Info (actn=getTiles) Gets the available tiles at the specified scale for the given location | ||
|---|---|---|
|
Parameter |
Description |
Valid Values |
|
tkn |
Authentication token returned from a getToken request |
Returned string from getToken request. Average length of string is 72–80 characters. Recommended authentication method. |
|
usrid |
Authentication returned from a getUserID request |
Returned string from getUserID request. Average length of string is 50–70 characters. To enable and disable UserIDs, visit the ArcWeb UserID account page. ESRI recommends using UserIDs only during phases of development and testing, when they offer more flexibility and convenience. ESRI recommends that you change your account password, which invalidates any existing UserIDs, and switch to using tokens before making an application public. |
|
c |
Map center point in x|y coordinates |
The x-coordinate of the center point and the y-coordinate of the center point in geographic coordinates (longitude/latitude), separated by a pipeline (|), for example, -117.1817|34.0556. See example URLs for details on using the c parameter to pan a map. |
|
sf |
Geographical scale of the map |
The distance ratio between two geographic locations and those two points represented on the map. The distance measured on the map can be any units, and that multiplied by the scale factor will give the actual distance in the measured units. For example, if the distance between two points on the map is 3 cm, for sf=100000, the geographic distance between the two points is 300,000 cm (3 multiplied by 100,000). |
|
ds |
Data source |
Valid values are |
|
w |
Map image width in pixels |
Default value is 400. Maximum width is 8192. |
|
h |
Map image height in pixels |
Default value is 400. Maximum height is 8192. |
| Map (actn=getTile) Gets a raster tile image at a specified level | ||
|---|---|---|
|
Parameter |
Description |
Valid Values |
|
tkn |
Authentication token returned from a getToken request |
Returned string from getToken request. Average length of string is 72–80 characters. Recommended authentication method. |
|
usrid |
Authentication returned from a getToken request |
Returned string from getUserID request. Average length of string is 50–70 characters. To enable and disable UserIDs, visit the ArcWeb UserID account page. ESRI recommends using UserIDs only during phases of development and testing, when they offer more flexibility and convenience. ESRI recommends that you change your account password, which invalidates any existing UserIDs, and switch to using tokens before making an application public. |
|
ds (required) |
Data source |
Valid values are |
|
lev (required) |
Tile level |
Higher levels indicate further zooming in. Valid values are all positive integers including zero (0). |
|
row (required) |
Row level |
Valid values are all positive integers including zero (0). |
|
col (required) |
Column level |
Valid values are all positive integers including zero (0). |
|
Error request |
Valid values are true or false. Default is false. If the parameter is set to true, an HTTP error is returned. If it is set to false, a request for a row or column that is in the valid range, but where no tile exists for that row/column, will result in a "Map imagery not available" image. |
|
| Copyright (actn=getCopyright) Gets a copyright for a raster tile image | ||
|---|---|---|
|
Parameter |
Description |
Valid Values |
|
tkn |
Authentication token returned from a getToken request |
Returned string from getToken request. Average length of string is 72–80 characters. Recommended authentication method. |
|
usrid |
Authentication returned from a getUserID request |
Returned string from getUserID request. Average length of string is 50–70 characters. To enable and disable UserIDs, visit the ArcWeb UserID account page. ESRI recommends using UserIDs only during phases of development and testing, when they offer more flexibility and convenience. ESRI recommends that you change your account password which invalidates any existing UserIDs, and switch to using tokens before making an application public. |
|
c |
Map center point in x|y coordinates |
The x-coordinate of the center point and the y-coordinate of the center point in geographic coordinates (longitude/latitude), separated by a pipeline (|). For example, -117.1817|34.0556. See Samples for details on using the c parameter to pan a map. |
|
sf |
Geographical scale of the map |
The distance ratio between two geographic locations and those two points represented on the map. The distance measured on the map can be any units, and that multiplied by the scale factor will give the actual distance in the measured units. For example, if the distance between two points on the map is 3 cm, for sf=100000, the geographic distance between the two points is 300,000 cm (3 multiplied by 100,000). |
|
ds |
Data source |
Valid values are |
|
w |
Map image width in pixels |
Default value is 400. Maximum width is 8192. |
|
h |
Map image height in pixels |
Default value is 400. Maximum height is 8192. |
Visit the Feedback page to give comments or suggestions about the ArcWeb Developer's Guide.