Overview | API | Data Structures | Parameters | Example Map
Version 2.0 of the TerraService is now available! Version 2.0 supports the Urban Area data theme. Click on Version 2.0 changes to learn the specific changes required in your application to use Version 2.0.
LonLatPt identifies a point on the surface of the earth in the Geographic projection — a Longitude and Latitude point. A valid Longitude value ranges from -180.0 to 180.0. Negative numbers identify the western hemisphere. Positive numbers identify the eastern hemisphere. A valid Latitude value ranges from -90.0 to 90.0. Negative numbers identify the southern hemisphere. Positive number identify the northern hemisphere.
public struct LonLatPt {
public Double Lon;
public Double Lat;
}
Input Parameter to: GetAreaFromPt, GetAreaFromRect, GetTileMetaFromPt, ConvertLonLatPtToNearestPlace, ConvertLonLatPtToUtmPt, CountPlacesInRect, GetLatLonMetrics, GetPlaceListInRect, GetTileMetaFromLonLatPt
The Place structure identifies the City, State, and Country of interest. The Place structure is typically passed to Place Name Search methods.
public struct Place {
public String City;
public String State;
public String Country;
}
Input Parameter to: ConvertPlaceToLonLatPt, GetPlaceFacts
The PlaceType enum identifies the Gazetteer category a Place name belongs to in the TerraServer database. Passing PlaceType.UnknownPlaceType is equivalent to asking for Places of "any" type.
public enum PlaceType {
UnknownPlaceType = 0,
AirRailStation = 1,
BayGulf = 2,
CapePeninsula = 3,
CityTown = 4,
HillMountain = 5,
Island = 6,
Lake = 7,
OtherLandFeature = 8,
OtherWaterFeature = 9,
ParkBeach = 10,
PointOfInterest = 11,
River = 12
}
Input Parameter to: GetPlaceListInRect, CountPlacesInRect
Contained in: CountPlacesInRect, PlaceFacts
TileId identifies a unique image tile in the TerraServer database.
public struct TileId {
public Theme Theme;
public Scale Scale;
public Int32 Scene;
public Int32 X;
public Int32 Y;
}
Input Parameter to: GetAreaFromTileId, GetTileMetaFromTileId, GetTile
Theme identifies the type of imagery. Currently, the TerraServer system supports four types of imagery — aerial imagery (photograph), scanned topographic map, natural color high-resolution imagery (urban area), and shaded relief (digital elevation). In version 2.0 of the TerraService, the Theme parameter is an Int32. In version 1.0, the Theme parameter was an enum type. The following table associates the Version 2.0 integer values with the version 1.0 enum values:
| Data Theme Name | Version 2.0 Integer | Version 1.0 Enum |
| Aerial Photograph (USGS DOQ) | 1 | Theme.Photo |
| Topographic Map (USGS DRG) | 2 | Theme.Topo |
| Shaded Relief | 3 | Theme.Relief |
| High-Resolution, Natural Color Ortho-Image (USGS Urban Area) | 4 | n/a |
Input Parameter to: GetAreaFromPt, GetAreaFromRect, GetTheme, GetTileMEtaFromLonLatPt
Scale identifies the ground resolution of the imagery. The base resolution in the TerraServer-USA system is 1 meter on a side. That is, each pixel covers one square meter of earth. All TerraServer imagery is in a power of 2 relative to 1 meter per pixel. Scale maps internal integer values used within the TerraServer database to a enum name.
public enum Scale {
Scale1mm = 0,
Scale2mm = 1,
Scale4mm = 2,
Scale8mm = 3,
Scale16mm = 4,
Scale32mm = 5,
Scale63mm = 6,
Scale125mm = 7,
Scale250mm = 8,
Scale500mm = 9,
Scale1m = 10,
Scale2m = 11,
Scale4m = 12,
Scale8m = 13,
Scale16m = 14,
Scale32m = 15,
Scale64m = 16,
Scale128m = 17,
Scale256m = 18,
Scale512m = 19,
Scale1km = 20,
Scale2km = 21,
Scale4km = 22,
Scale8km = 23,
Scale16km = 24
}
Input Parameter to: GetAreaFromPt, GetAreaFromRect, GetTileMetaFromLonLatPt
The UtmPt structure contains a UTM coordinate point. The X field is the UTM Easting value. The Y field is the UTM northing. The Zone field identifies the UTM zone number. Valid Zone values range from 1 thru 60. The Zone field can be extracted from the Scene field in a TileId structure.
public struct UtmPt {
public int Zone;
public double X;
public double Y;
}
Input Parameter to: UtmPt
