Geoprocessing tool reference > Server toolbox > Caching toolset > Tools
Update Globe Server Cache (Server) |
|
|
Release 9.2
Last modified November 22, 2006 |
Print all topics in : "Tools" |
Updates an existing Globe Service cache to replace missing tiles, overwrite outdated tiles, or add new tiles in new areas. Update Globe Server Cache tool works on a single layer or on all layers of the Service.
There are two modes of operation:
- Recreate Empty Tiles — Only tiles that are empty (have been deleted on disk), or that are new because the cache extent has changed or because new
- Recreate All Tiles — All tiles, including existing tiles, will be replaced. Additionally new tiles will be added if a layers data extent has changed or new layers have been added to the globe service.
layers have been added to the globe service, will be created. Existing tiles
will be left unchanged.
Usage tips
-
This tool should be used to update an existing globe server cache. To update a cache, specify the Globe server host. The tool will automatically list all server objects available on that server.
-
Running update without specifying an extent will update the entire extent of the service being for the specified levels of detail.
-
Update is useful to run when you need to update only a portion of the globe services cache. When specifying the 'from' and 'To' Levels of detail make sure you specify all levels you want tiles generated for. The From Level of Detail defines the lowest level of detail you'd want your data cache to begin with. The To Level of detail defines the highest resolution you'd want your data caching to have.
-
This tool does not accept any Environment Setting that have been specified.
Command line syntax
An overview of the Command Line window
UpdateGlobeServerCache_Server <server_name> <object_name> {update_extent} <layer;layer...> <LOD_from> <LOD_to> {thread_count} <Recreate Empty Tiles | Recreate All Tiles>
| Parameter | Explanation | Data Type |
| <server_name> |
The host name of the ArcGIS Server to use to update the cache. |
String |
| <object_name> |
The name of the Globe Service to use to update the cache. |
String |
| {update_extent} |
Choose an area of the layer for which the cache should be updated. You can do so by specifying the extent values or choosing an extent from an existing data source.
NOTE: Choosing a new cache extent will update tiles in every level of detail that intersects that extent. |
Extent |
| <layer;layer...> |
Update the data cache of the chosen layers. All layers are checked by default. If a layer is unchecked update will not affect the layer. |
String |
| <LOD_from> |
The minimum level of detail of the data cache building. Each level of detail corresponds to a fixed scale. These levels are fixed and correspond to the ArcGlobe's data tiling scheme. There are 21 levels of detail available: Globe - 1:10000000 | Continent - 1:5000000 | Countries - 1:2500000 | Country - 1:1250000 | States - 1:625000 | State - 1:312500 | Counties - 1:156250 | County - 1:78125 | Metropolitan Area - 1:39062 | Cities - 1:19531 | City - 1:9765 | Town - 1:4882 | Neighborhood - 1:2441 | City Blocks - 1:1220 | City Block - 1:610 | Buildings - 1:305 | Building - 1:152 | Houses - 1:76 | House Property - 1:38 | House - 1:19 | Rooms - 1:9 | Room - 1:4. |
String |
| <LOD_to> |
The maximum level of detail of the data cache building. Each level of detail corresponds to a fixed scale. These levels are fixed and correspond to the ArcGlobe's data tiling scheme. There are 21 levels of detail available: Globe - 1:10000000 | Continent - 1:5000000 | Countries - 1:2500000 | Country - 1:1250000 | States - 1:625000 | State - 1:312500 | Counties - 1:156250 | County - 1:78125 | Metropolitan Area - 1:39062 | Cities - 1:19531 | City - 1:9765 | Town - 1:4882 | Neighborhood - 1:2441 | City Blocks - 1:1220 | City Block - 1:610 | Buildings - 1:305 | Building - 1:152 | Houses - 1:76 | House Property - 1:38 | House - 1:19 | Rooms - 1:9 | Room - 1:4. |
String |
| {thread_count} |
Specifies the number of ArcGIS Server Globe Server Instances to use to create the cache. This number defaults to the maximum number of Globe Server instances specified in the Globe Service properties, but can be changed to a lesser number. |
Long |
| <Recreate Empty Tiles | Recreate All Tiles> |
Choose a mode for updating the cache. The two modes are:
|
Boolean |
Command line example
UpdateGlobeServerCache myglobeserver Boundaries "Globe - 1:10000000" "Countries - 1:2500000" 4 'ESRI Countries (Small Scale)';'ESRI Countries (Medium Scale)';LargeProvinces;'ESRI AWS Boundaries';'AND Countries'
Scripting syntax
About getting started with writing geoprocessing scripts
UpdateGlobeServerCache_Server (server_name, object_name, update_extent, layer, LOD_from, LOD_to, thread_count, update_mode)
| Parameter | Explanation | Data Type |
| server_name (Required) |
The host name of the ArcGIS Server to use to update the cache. |
String |
| object_name (Required) |
The name of the Globe Service to use to update the cache. |
String |
| update_extent (Optional) |
Choose an area of the layer for which the cache should be updated. You can do so by specifying the extent values or choosing an extent from an existing data source.
NOTE: Choosing a new cache extent will update tiles in every level of detail that intersects that extent. |
Extent |
| layer (Required) |
Update the data cache of the chosen layers. All layers are checked by default. If a layer is unchecked update will not affect the layer. |
String |
| LOD_from (Required) |
The minimum level of detail of the data cache building. Each level of detail corresponds to a fixed scale. These levels are fixed and correspond to the ArcGlobe's data tiling scheme. There are 21 levels of detail available: Globe - 1:10000000 | Continent - 1:5000000 | Countries - 1:2500000 | Country - 1:1250000 | States - 1:625000 | State - 1:312500 | Counties - 1:156250 | County - 1:78125 | Metropolitan Area - 1:39062 | Cities - 1:19531 | City - 1:9765 | Town - 1:4882 | Neighborhood - 1:2441 | City Blocks - 1:1220 | City Block - 1:610 | Buildings - 1:305 | Building - 1:152 | Houses - 1:76 | House Property - 1:38 | House - 1:19 | Rooms - 1:9 | Room - 1:4. |
String |
| LOD_to (Required) |
The maximum level of detail of the data cache building. Each level of detail corresponds to a fixed scale. These levels are fixed and correspond to the ArcGlobe's data tiling scheme. There are 21 levels of detail available: Globe - 1:10000000 | Continent - 1:5000000 | Countries - 1:2500000 | Country - 1:1250000 | States - 1:625000 | State - 1:312500 | Counties - 1:156250 | County - 1:78125 | Metropolitan Area - 1:39062 | Cities - 1:19531 | City - 1:9765 | Town - 1:4882 | Neighborhood - 1:2441 | City Blocks - 1:1220 | City Block - 1:610 | Buildings - 1:305 | Building - 1:152 | Houses - 1:76 | House Property - 1:38 | House - 1:19 | Rooms - 1:9 | Room - 1:4. |
String |
| thread_count (Optional) |
Specifies the number of ArcGIS Server Globe Server Instances to use to create the cache. This number defaults to the maximum number of Globe Server instances specified in the Globe Service properties, but can be changed to a lesser number. |
Long |
| update_mode (Required) |
Choose a mode for updating the cache. The two modes are:
|
Boolean |
Data types for geoprocessing tool parameters
Script example
# Importing standard library modules
import os, arcgisscripting
# Create the geoprocessing object
gp = arcgisscripting.create()
gp.UpdateGlobeServerCache("myglobeserver","Boundaries","Globe - 1:10000000","Countries - 1:2500000", 4,"'ESRI Countries (Small Scale)';'ESRI Countries Medium Scale)';LargeProvinces;'ESRI AWS Boundaries';'AND Countries'")