GBDX

WORLDVIEW-2

Overview

WorldView-2 has collected high-resolution, 8-band multi-spectral imagery since its launch in October 2009. This satellite is capable of collecting up to one million square kilometers of 8-band imagery per day.

Uses
Worldview-2’s highly detailed imagery is ideal for in-depth image analysis, change detection, and precise map creation.

Spectral Bands

Panchromatic band
Multispectral 4-band: 4 standard VNIR colors are blue, green, red, near-IR1
Multispectral 8-band: 4 additional VNIR colors are coastal, yellow, red edge, and near-IR2

Date Range
October 2009 – present

Products available through GBDX
DigitalGlobe Basic (Level 1B imagery)

See the Worldview-2 Data Sheet for more details.

Worldview-2 Multispectral image.

Types

TypeDescription
WV02Worldview-2, multispectral imagery

Search

Using the GBDX Catalog V2 API, search by "types" to find Worldview-2 data. To narrow the search results set, include area, date range, or both. Search results can be further filtered by the properties of a Worldview-2 record.

Catalog V2 API Request

Send a POST request to //geobigdata.io/catalog/v2/search with a request body.

For gbdxtools, see Catalog Search Overview

Search Examples

Search Example 1: Search for WV02 Acquisitions

This search will return Worldview-2 Acquisitions within the specified area and date range.

{
        "searchAreaWkt": "POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))",
        "startDate": "2014-01-01T00:00:00.000Z",
        "endDate": "2014-12-31T23:59:59.999Z",
        "types": ["WV02",
            "DigitalGlobeAcquisition"
            ]
    }

Search Example 1: Results for Search for Worldview-2 Acquisitions

{
    "stats": {
        "recordsReturned": 104,
        "totalRecords": 104,
        "typeCounts": {
            "GBDXCatalogRecord": 104,
            "DigitalGlobeAcquisition": 104,
            "WV02": 104,
            "Acquisition": 104
        }
    },
    "results": [
        {
            "identifier": "10300100310B9700",
            "type": [
                "GBDXCatalogRecord",
                "Acquisition",
                "DigitalGlobeAcquisition",
                "WV02"
            ],
            "properties": {
                "offNadirAngle_min": 4.24724817276001,
                "offNadirAngle_start": 4.24724817276001,
                "targetAzimuth_min": 45.6495552062988,
                "multiResolution_min": 1.86532092094421,
                "cloudCover": 34,
                "sunAzimuth_max": 149.386505126953,
                "targetAzimuth": 53.4701919555664,
                "multiResolution": 1.86890339851379,
                "catalogID": "10300100310B9700",
                "panResolution_max": 0.469323724508286,
                "timestamp": "2014-06-01T18:15:39.786Z",
                "sunAzimuth_min": 149.129730224609,
                "browseURL": [the full path browse url to view the image],
                "targetAzimuth_max": 66.2394714355469,
                "sunAzimuth": 149.281860351562,
                "sunElevation_min": 70.3070907592773,
                "offNadirAngle": 5.10616874694824,
                "stereoPair": null,
                "platformName": "WORLDVIEW02",
                "multiResolution_start": 1.86532092094421,
                "sunElevation": 70.3632507324219,
                "vendor": "DigitalGlobe",
                "scanDirection": "Reverse",
                "panResolution_end": 0.469323724508286,
                "panResolution_start": 0.467363953590393,
                "targetAzimuth_end": 45.6495552062988,
                "panResolution_min": 0.467363953590393,
                "offNadirAngle_max": 5.7432975769043,
                "multiResolution_end": 1.87170243263245,
                "multiResolution_max": 1.87170243263245,
                "sunElevation_max": 70.4447402954102,
                "offNadirAngle_end": 5.7432975769043,
                "panResolution": 0.468463450670242,
                "footprintWkt": "MULTIPOLYGON(((-105.0380409 39.62433512, -105.2305074 39.62390724, -105.2304449 39.66571007, -105.2305678 39.70745478, -105.2303527 39.74950147, -105.2303394 39.76013394, -105.0373228 39.7609004, -105.0373665 39.75021652, -105.0375991 39.7082254, -105.037833 39.6662564, -105.0380409 39.62433512)))",
                "targetAzimuth_start": 66.2394714355469,
                "imageBands": "PAN_MS1_MS2",
                "sensorPlatformName": "WORLDVIEW02"
            }
        },
      
      [results truncated]

Search Example 2: Search for Worldview-2 1B Products

This search will return Worldview-2 products within the specified area and date range.

{
        "searchAreaWkt": "POLYGON ((-105.35202026367188 39.48113956424843, -105.35202026367188 40.044848254075546, -104.65988159179688 40.044848254075546, -104.65988159179688 39.48113956424843, -105.35202026367188 39.48113956424843))",
        "startDate": "2018-01-01T00:00:00.000Z",
        "endDate": "2018-12-31T23:59:59.999Z",
        "types": ["WV02",
            "1BProduct" 
            ]
  }

Search Example 2: Results for Search for Worldview-2 1B Products

{
    "stats": {
        "recordsReturned": 76,
        "totalRecords": 76,
        "typeCounts": {
            "GBDXCatalogRecord": 76,
            "1BProduct": 76,
            "WV02": 76,
            "DigitalGlobeProduct": 76
        }
    },
    "results": [
        {
            "identifier": "10300100302EF900_P004_PAN_055825243010",
            "type": [
                "GBDXCatalogRecord",
                "WV02",
                "DigitalGlobeProduct",
                "1BProduct"
            ],
            "properties": {
                "rpbFile": "14APR08180529-P1BS-055825243010_01_P004.RPB",
                "sunAzimuth": 155,
                "cloudCover": 0,
                "catalogID": "10300100302EF900",
                "xmlFile": "14APR08180529-P1BS-055825243010_01_P004.XML",
                "timestamp": "2014-04-08T18:05:29.000Z",
                "attFile": "14APR08180529-P1BS-055825243010_01_P004.ATT",
                "browseJpgFile": "14APR08180529-P1BS-055825243010_01_P004-BROWSE.JPG",
                "offNadirAngle": 32.2,
                "platformName": "WORLDVIEW02",
                "sunElevation": 55.3,
                "vendor": "DigitalGlobe",
                "soli": "055825243",
                "bands": "P",
                "bucketPrefix": "055825243010_01_003/055825243010_01/055825243010_01_P004_PAN",
                "readmeTxtFile": "14APR08180529-P1BS-055825243010_01_P004_README.TXT",
                "imageFile": "14APR08180529-P1BS-055825243010_01_P004.TIF",
                "part": 4,
                "bucketName": "receiving-dgcs-tdgplatform-com",
                "resolution": 0.636,
                "footprintWkt": "MULTIPOLYGON(((-105.067352908 39.9357906672, -104.820067685 39.9757385839, -104.819280124 39.8498874659, -105.067121813 39.8087908182, -105.067352908 39.9357906672)))",
                "geoFile": "14APR08180529-P1BS-055825243010_01_P004.GEO",
                "tilFile": "14APR08180529-P1BS-055825243010_01_P004.TIL",
                "sensorPlatformName": "WORLDVIEW02",
                "productLevel": "LV1B",
                "imdFile": "14APR08180529-P1BS-055825243010_01_P004.IMD",
                "ephFile": "14APR08180529-P1BS-055825243010_01_P004.EPH",
                "bandsList": "BAND_P"
            }
        },
      
      [Results truncated to show one record]

Worldview-2 1B Product Properties

The following identifying information, properties, and metadata files are associated with a Worldview-2 product in the GBDX catalog.

PropertyDescriptionValues
bandsIndicates panchromatic image or multispectral image"Pan" or "Multi"
bandsListThe specific bands that are part of this product.Example: BAND_B,BAND_G,BAND_R,BAND_N
bucketNamename of the AWS receiving bucket the product is stored in.n/a
bucketPrefixThe customer's AWS Prefix. This is typically the Account ID.n/a
catalogIDThe catalog ID for the acquisition this product is derived from.Example catalog ID: 1020010007AF7100
cloudCoverEstimate of the max cloud-covered fraction of the product component.0.000 to 1.000, -999.000 if not assessed.
footprintWktThe spatial area for a search. A Well-Known Text (WKT) representation of the shape (footprint, geometry) that defines the LocationMULTIPOLYGON
identifierThe identifier for the product, also referred to as "product ID".1040010006129900_P001_MUL_056814719010
imageFileThe product image. The file extension is .tiff.n/a
offNadirAngleThe spacecraft elevation angle measured from nadir to the image center as seen from the spacecraft at the time the strip or substrip was acquired.: ≥ 0.0, decimal points may vary.
partThe part ID for an order.For this property, the value is a single digit. For example, part: 5. The part ID is indicated in the Product ID and the metadata file names as "00x", or in this example, "005".
platformNameSee "sensorPlatformName". This field exists for backwards compatibility purposes only.n/a
productLevelAt this time, Catalog V2 only catalogs Level 1B products. A 1B product is a "basic" DigitalGlobe product.1B
resolutionThe resampled image pixel size derived from Ground Sample Distance (GSD).Example: 0.588
sensorPlatformNameThe name of the DigitalGlobe satellite that captured the acquisition this product is derived from.See all DG satellites.
soliSales Order Line ItemExample: 055734390
sunAzimuthThe azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north.Range: 0.00000 – 360.00000
sunElevationThe angle of the sun above the horizon. A negative sun elevation indicates a night time image.Range: ±90.0
timestampThe timestamp on the acquisition the product is derived from.Example: 2014-07-12T17:40:46.000Z
VendorFor products, the vendor is DigitalGlobe.N/A

Image Support Data (DigitalGlobe Products)

DigitalGlobe products have a set of metadata files called Image Support Data (ISD). The files included with a DigitalGlobe product on GBDX are:

FileDetails
attFileAttitude File, File extension is Attitude File. The attitude file includes the time of first data point, the number of points, and the interval between the points and attitude information.
browseJpgFileProduct Browse File, File extension is .JPG. The product browse file is a JPEG compressed browse image of the delivered product.
ephFileEphemeris File, File extension is .EPH. The ephemeris file includes the time of first data point, the number of points, and the interval between the points and ephemeris information.
geoFileGeometric Calibration File, File extension is .GEO. The geometric calibration file contains the standard photogrammetric parameters of a virtualcamera that models the corresponding camera and optical system for Basic Imagery products
imdFileImage Metadata Fle, File extension is .IMD. The image metadata file describes key attributes about the image product, including product level, corner coordinates, and projection information, and time of acquisition.
readmeTxtFileProduct Component Index File, File extension is .TXT.he README file provides copyright information and the names of the ISD files for a single product within a delivery.
rpbFileRPC00B File, File extension is .RPB. The RPC00B file contains the RPC information, which can be used to rectify the image. This is a mathematical mapping from object space coordinates to image space coordinates.
tilFileTile Map File, File extension is .RPB. The tile map file assists the customer in determining what tile to ingest to look at a specific part of the order polygon.
xmlFileXML File, File extension is .XML. This file contains the same information as the combined README, Licensing, Image Metadata, Tile Map and RPC00Bfiles, in XML format. For Basic Imagery Products, the attitude, ephemeris, and geometric calibration file are included as well.

These files cannot be viewed in the GBDX Receiving Bucket, but they can be passed into a task.

Worldview-2 Acquisition Properties

These are the properties associated with a Worldview-2 Acquisition:

PropertyDescriptionValues
browseURLThis is the browse url fto view the image
catalogIDDigitalGlobe CatalogID for the raw data (acquisition). This is sometimes referred to as the "acquisition ID"Ex.: 1020010007AF7100
cloudCoverEstimate of the max cloud-covered fraction of the product component.0.000 to 1.000, -999.000 if not assessed.
footprintWktThe spatial area for a search. A Well-Known Text (WKT) representation of the shape (footprint, geometry) that defines the LocationMULTIPOLYGON
identifierThe "identifier" for a DigitalGlobe acquisition is the catalog ID1020010007AF7100
imageBandsthe image bands available for the imagePan_MS1_MS2, Multispectral, 8-band
multiResolutionmultispectral resolution2.41480398178101
multiResolution_endThe multispectral resolution at the end of the collect2.40671253204346
multiResolution_maxThe maximum multispectral resolution in the collect2.42567181587219
multiResolution_minThe minimum multispectral resolution in the collect0.600724101066589
multiResolution_startThe multispectral resolution of the start of of the collect0.605704009532928
offNadirAngleThe spacecraft elevation angle measured from nadir to the image center as seen from the spacecraft at the time the strip or substrip was acquired.: ≥ 0.0, decimal points may vary.
offNadirAngle_maxThe maximum spacecraft elevation angle measured from nadir to the product center-line as seen from thespacecraft.0.0 to 90.0
offNadirAngle_endThe end of the spacecraft elevation angle measured from nadir to the image center as seen from the spacecraft at the time the strip or substrip was acquired.Example: 33.7915306091309
offNadirAngle_minThe maximum spacecraft elevation angle measured from nadir to the product center-line as seen from the spacecraft.0.0 to 90.0, Example: 30.0960826873779
OffNadirAngle_startThe start of the spacecraft elevation angle measured from nadir to the image center as seen from the spacecraft at the time the strip or substrip was acquired.Example: 30.0960826873779
panResolutionPanchromatic resolution0.602808654308319
panResolution_endThe panchromatic resolution at the end of the collect0.600724101066589
panResolution_maxThe maximum panchromatic resolution in the collect0.605704009532928
panResolution_minThe minimum panchromatic resolution in the collect0.600724101066589
panResolution_starthe panchromatic resolution at the start of the collect0.605704009532928
platformNameThe name of the sensor platform that acquired the data. platformName is in longhand, for example: WORLDVIEW02. This property is identical to "sensorPlatformName" below.N/A
scanDirectionThe scan direction of the sensor when the acquisition was captured.Values are "Forward" or "Reverse". The sensor platform Quickbird uses "forward" only.
sensorPlatformNameThe name of the sensor platform that acquired the data. sensorPlatformName is in longhand, for example: WORLDVIEW02. This property is identical to "platformName" above.N/A
stereoPairStereo pair data is not available on GBDX at this time.N/A
sunAzimuthThe azimuth of the sun as seen by an observer sitting on the target measured in a clockwise direction from north.Range: 0.00000 – 360.00000
sunAzimuth_maxMaximum azimuth angle of the sun measured from north clockwise.0.0 to 360.0
sunAzimuth_minMinimum azimuth angle of the sunmeasured from north clockwise.0.0 to 360.0
sunElevationThe angle of the sun above the horizon. A negative sun elevation indicates a night time image.Range: ±90.0
sunElevation_maxMaximum angle of the sun. A negative sun elevation indicates a night time image..±90.0
sunElevation_minMinimum angle of the sun measured from north clockwise. A negative sun elevation indicates a night time image.±90.0
targetAzimuthThe azimuth of the target as seen by an observer sitting on the spacecraft measured in a clockwise direction from north.49.6538887023926
targetAzimuth_endThis is the maximum target azimuth in the collect50.8807907104492
targetAzimuth_maxThis is the end of the target Azimuth for this collect50.8807907104492
targetAzimuth_minThis is the minimum target azimuth in the collect48.0979080200195
targetAzimuth_startThis is the start of the target Azimuth for this collect48.0979080200195
timestampThe timestamp shows the date and time the acquisition data was collectedEx. 2014-09-07T18:01:40.000Z
vendorThe data providerEx. DigitalGlobe

Sensor Platforms and Image Bands


SensorPlatformName |ImageBands |Description
--- | ---
GEOEYE01 | Pan_MS1 | Multispectral, 4-band
QUICKBIRD02| Pan_MS1 |Multispectral, 4-band
WORLDVIEW01 |Pan |Black & White (Panchromatic)
WORLDVIEW02 |Pan_MS1_MS2 | Multispectral, 8-band
WORLDVIEW03 | Pan_MS1_MS2, SWIR | Multispectral, 8-band; Shortwave infrared, 8-band,

Identifiers

Catalog ID

The Catalog ID is the vendor's identifying information for the acquisition data collected by the satellite. This is sometimes referred to as the "acquisition ID." The catalog ID for the acquisition is also displayed in the properties for products derived from that acquisition. The catalog ID is used to place an order for a product.

Example Acquisition Catalog ID: 1020010007AF7100

Product ID

For a DigitalGlobe product, the "identifier" field is the product ID.

The format of the product ID is:

<catid>_<part>_<band comb (MSI, PAN, SWR)>_<soli>

Example: 10300100301DCE00_P002_MUL_055825267010.

In this example:

ComponentValue
catid10300100301DCE00
part002
band combination(MSI, PAN, SWR)
soli (sales order line item)055825267010

S3 location

s3://bucketName/bucketPrefix/File name

The bucketName, bucketPrefix, and file name can all be found in the response body for a DigitalGlobeProduct.

Updated about a year ago

WORLDVIEW-2


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.