agi.foundation.terrain

(agi.foundation.terrainreaders-2025r1.jar)

Class GeospatialContentServerTerrain

java.lang.Object

agi.foundation.terrain.TerrainProvider

agi.foundation.terrain.QuantizedMeshTerrainProvider

agi.foundation.terrain.GeospatialContentServerTerrain

public class GeospatialContentServerTerrain
extends QuantizedMeshTerrainProvider

A terrain provider for reading terrain data from a Geospatial Content Server (GCS). This can be a server on the internet, your local network, or your local machine.

The terrain data used by this class is tile-based, in quantized-mesh format.

Constructor Summary

Constructors

Constructor and Description
GeospatialContentServerTerrain(String assetUrl, IAuthorizationProvider authorizationProvider) Initializes a new instance.
GeospatialContentServerTerrain(String assetUrl, IAuthorizationProvider authorizationProvider, int zoomLevel) Initializes a new instance.
GeospatialContentServerTerrain(String assetUrl, IAuthorizationProvider authorizationProvider, int zoomLevel, Proxy proxy) Initializes a new instance.
GeospatialContentServerTerrain(String assetUrl, IAuthorizationProvider authorizationProvider, int zoomLevel, TerrainCacheGroup cacheGroup) Initializes a new instance.
GeospatialContentServerTerrain(String assetUrl, IAuthorizationProvider authorizationProvider, int zoomLevel, TerrainCacheGroup cacheGroup, Proxy proxy) Initializes a new instance.
GeospatialContentServerTerrain(String assetUrl, IAuthorizationProvider authorizationProvider, Proxy proxy) Initializes a new instance.
GeospatialContentServerTerrain(String assetUrl, IAuthorizationProvider authorizationProvider, TerrainCacheGroup cacheGroup) Initializes a new instance.
GeospatialContentServerTerrain(String assetUrl, IAuthorizationProvider authorizationProvider, TerrainCacheGroup cacheGroup, Proxy proxy) Initializes a new instance.

Method Summary

Modifier and Type	Method and Description
String	getAssetUrl() Gets the asset URL for this terrain provider.
QuantizedMeshTerrainTile	getMesh(int level, int x, int y) Gets a mesh for a specified set of coordinates.

Methods inherited from class agi.foundation.terrain.QuantizedMeshTerrainProvider

extentToCoordinateExtent, findMostDetailedAvailableTile, getCache, getDefaultInterpolator, getFirstPartials, getFirstPartials, getHeight, getHeight, getHeightNativeUnits, getLocalMinimumSampleSpacing, getMaximumLevel, getMetadata, getMinimumSampleSpacing, getNumberOfXTilesAtLevel, getNumberOfYTilesAtLevel, getSecondPartials, getSecondPartials, getZoomLevel, isTileAvailable, latitudeToYTileCoordinate, longitudeToXTileCoordinate, preloadExtent, setDefaultInterpolator, setZoomLevel, tileCoordinatesToExtent, unloadExtent, validateTileCoordinates

Methods inherited from class agi.foundation.terrain.TerrainProvider

getBoundingExtent, getBoundingExtentNativeUnits, getGradient, getHeightReference, getHeightRelativeToShape, getHessian, getNativeToMeters, getNormal, getRadiansToNative, getReferenceSurface, getShape, getShapeFixedFrame, inGlobalBounds, setBoundingExtent, setBoundingExtentNativeUnits, setHeightReference, setNativeToMeters, setRadiansToNative, setReferenceSurface, setShape, setShapeFixedFrame

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GeospatialContentServerTerrain

public GeospatialContentServerTerrain(@Nonnull
                                      String assetUrl,
                                      @Nonnull
                                      IAuthorizationProvider authorizationProvider)

Initializes a new instance.

Parameters:

assetUrl - The Asset URL of the terrain.

authorizationProvider - A provider for the authorization token required to access the asset in GCS.

GeospatialContentServerTerrain

public GeospatialContentServerTerrain(@Nonnull
                                      String assetUrl,
                                      @Nonnull
                                      IAuthorizationProvider authorizationProvider,
                                      int zoomLevel)

Initializes a new instance.

Parameters:

assetUrl - The Asset URL of the terrain.

authorizationProvider - A provider for the authorization token required to access the asset in GCS.

zoomLevel - The Tile Map Service zoom level to request tiles at.

GeospatialContentServerTerrain

public GeospatialContentServerTerrain(@Nonnull
                                      String assetUrl,
                                      @Nonnull
                                      IAuthorizationProvider authorizationProvider,
                                      @Nonnull
                                      TerrainCacheGroup cacheGroup)

Initializes a new instance.

Parameters:

assetUrl - The Asset URL of the terrain.

authorizationProvider - A provider for the authorization token required to access the asset in GCS.

cacheGroup - The cache group of which this provider is a member.

GeospatialContentServerTerrain

public GeospatialContentServerTerrain(@Nonnull
                                      String assetUrl,
                                      @Nonnull
                                      IAuthorizationProvider authorizationProvider,
                                      @Nullable
                                      Proxy proxy)

Initializes a new instance.

Parameters:

assetUrl - The Asset URL of the terrain.

authorizationProvider - A provider for the authorization token required to access the asset in GCS.

proxy - The proxy to use when connecting. Optional, default is null.

GeospatialContentServerTerrain

public GeospatialContentServerTerrain(@Nonnull
                                      String assetUrl,
                                      @Nonnull
                                      IAuthorizationProvider authorizationProvider,
                                      int zoomLevel,
                                      @Nonnull
                                      TerrainCacheGroup cacheGroup)

Initializes a new instance.

Parameters:

assetUrl - The Asset URL of the terrain.

authorizationProvider - A provider for the authorization token required to access the asset in GCS.

zoomLevel - The Tile Map Service zoom level to request tiles at.

cacheGroup - The cache group of which this provider is a member.

Throws:

ArgumentNullException - Thrown when assetUrl, authorizationProvider, or cacheGroup is null.

GeospatialContentServerTerrain

public GeospatialContentServerTerrain(@Nonnull
                                      String assetUrl,
                                      @Nonnull
                                      IAuthorizationProvider authorizationProvider,
                                      int zoomLevel,
                                      @Nullable
                                      Proxy proxy)

Initializes a new instance.

Parameters:

assetUrl - The Asset URL of the terrain.

authorizationProvider - A provider for the authorization token required to access the asset in GCS.

zoomLevel - The Tile Map Service zoom level to request tiles at.

proxy - The proxy to use when connecting. Optional, default is null.

Throws:

ArgumentNullException - Thrown when assetUrl or authorizationProvider is null.

GeospatialContentServerTerrain

public GeospatialContentServerTerrain(@Nonnull
                                      String assetUrl,
                                      @Nonnull
                                      IAuthorizationProvider authorizationProvider,
                                      int zoomLevel,
                                      @Nonnull
                                      TerrainCacheGroup cacheGroup,
                                      @Nullable
                                      Proxy proxy)

Initializes a new instance.

Parameters:

assetUrl - The Asset URL of the terrain.

authorizationProvider - A provider for the authorization token required to access the asset in GCS.

zoomLevel - The Tile Map Service zoom level to request tiles at.

cacheGroup - The cache group of which this provider is a member.

proxy - The proxy to use when connecting. Optional, default is null.

Throws:

ArgumentNullException - Thrown when assetUrl, authorizationProvider, or cacheGroup is null.

GeospatialContentServerTerrain

public GeospatialContentServerTerrain(@Nonnull
                                      String assetUrl,
                                      @Nonnull
                                      IAuthorizationProvider authorizationProvider,
                                      @Nonnull
                                      TerrainCacheGroup cacheGroup,
                                      @Nullable
                                      Proxy proxy)

Initializes a new instance.

Parameters:

assetUrl - The Asset URL of the terrain.

authorizationProvider - A provider for the authorization token required to access the asset in GCS.

cacheGroup - The cache group of which this provider is a member.

proxy - The proxy to use when connecting. Optional, default is null.

Throws:

ArgumentNullException - Thrown when assetUrl, authorizationProvider, or cacheGroup is null.

Method Detail

getMesh

public QuantizedMeshTerrainTile getMesh(int level,
                                        int x,
                                        int y)

Gets a mesh for a specified set of coordinates. This method is not expected to do any caching.

Specified by:

getMesh in class QuantizedMeshTerrainProvider

Parameters:

level - The zoom level.

x - The X tile coordinate.

y - The Y tile coordinate.

Returns:

The requested mesh.

Throws:

DataUnavailableException - Thrown when the requested tile does not exist.

ArgumentOutOfRangeException - Thrown when the tile coordinates are invalid.

getAssetUrl

@Nonnull
public final String getAssetUrl()

Gets the asset URL for this terrain provider.