Summary
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 for this tool:
- 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 layers have been added to the globe service, will be created. Existing tiles will be left unchanged.
- 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.
Usage
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.
Syntax
arcpy.server.UpdateGlobeServerCache(server_name, object_name, {update_extent}, Layer, lod_from, lod_to, {thread_count}, update_mode)| 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 (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. | Extent |
Layer [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 (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 | Choose a mode for updating the cache. The two modes are:
| String |
Code sample
# Importing standard library modules
import 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'")
Environments
This tool does not use any geoprocessing environments.
Licensing information
- Basic: Requires 3D Analyst
- Standard: Requires 3D Analyst
- Advanced: Requires 3D Analyst