Mosaic

Mosaic image

Implements

Fields

acres (Float!)
Deprecation notice

Support added for metric units. Please use area instead.

The number of acres that the mosaic contains.

action (UpsertActionType!)

Determines if it was a create or update.

analytic (Analytic)

The analytic which this deliverable fulfills.

area (Area!)
Deprecation notice

The server will no longer calculate the area of the mosaic. Results are indeterminate.

The area covered by the mosaic.

Argument Type Description
unit AreaUnitType

The unit in which a client would like the area.

unit_system UnitSystem

The unit system in which a client would like the area. Defaults to IMPERIAL if not provided.

bands ([MosaicBand!])

Information about the bands in mosaic images. Sentera produced mosaics have a band order of R, G, B, RE, NIR.

camera_profile (String)

Camera profile used to create the scheme of the images that are used to generate this mosaic.

captured_at (String!)

The date and time when this mosaic image was captured.

cogs ([Cog!])

A list of cogs associated with this mosaic.

content_hash (String!)

The current content hash for this item.

created_at (ISO8601DateTime!)

Date and time this deliverable was created.

created_by (User!)

The user that uploaded this deliverable.

custom_name (String)
Deprecation notice

Please use the name field.

Custom name for a custom indexed mosaic.

deliverable_key (DeliverableKey)

An identifier indicating what type of deliverable this is.

files ([File]!)

A collection of files associated with this mosaic.

image_status (MosaicImageStatus!)

The status of this mosaic.

images (ImagesQueryResult!)

A list of images associated with this mosaic.

Argument Type Description
haversine_radius HaversineRadius

Filter the results by haversine radius.

pagination Pagination

Paginate the results.

is_from_sentera_sensor (Boolean!)

Indicator stating if the images for this mosaic were collected by a Sentera sensor.

message (String)

A general message associated with this mosaic.

mosaic_type (MosaicType!)

The type of mosaic.

name (String!)

Name of the mosaic.

order (Analytic)
Deprecation notice

Please use analytic instead.

The analytic which this deliverable fulfills.

quality (MosaicQuality!)

The quality indicator for this mosaic.

released (Boolean!)

Has this data been released to customers.

s3_uri (String)

The s3 location where the mosaic is stored.

sentera_id (ID!)

A system-generated key identifying a specific instance of a mosaic.

spatial_resolution (Int)

Physical dimension that represents a pixel of the images used to generate this mosaic.

style_properties (MosaicStyleProperties)

Style properties used to specify how the mosaic is initially rendered by a FieldAgent client.

survey (Survey!)

The associated survey of this mosaic.

updated_at (ISO8601DateTime!)

The timestamp of when the item was last updated in the system.

updated_by (User)

The user who last updated this item.

Examples

Mosaic by Sentera ID

Retrieve a mosaic

Try this example in GraphiQL
query MosaicBySenteraID {
  mosaic(sentera_id: "itqkn28_MO_SHORT1_CV_test_dc0d87d_170907_235328") {
  sentera_id
  quality
  mosaic_type
  }
}

{
  "data": {
  "mosaic": {
    "sentera_id": "itqkn28_MO_SHORT1_CV_test_dc0d87d_170907_235328",
    "quality": "quick",
    "mosaic_type": "RGB"
  }
  }
}

Mosaic with COGs

Retrieve a mosaic and all of its COGs

Try this example in GraphiQL
query MosaicWithCogs {
  mosaic(sentera_id:"kdyhnkz_MO_j0otAcmeOrg_CV_shar_ec1284b_190521_205712") {
  sentera_id
  cogs {
    status
    clipped
    url
    error
    max_zoom
    bbox
  }
  }
}

{
  "data": {
  "mosaic": {
    "sentera_id": "kdyhnkz_MO_j0otAcmeOrg_CV_shar_ec1284b_190521_205712",
    "cogs": [
      {
        "status": "FAIL",
        "clipped": true,
        "url": null,
        "error": "Failed to ungrayscale input image: Expected number of bands to be in (2, 4), but found 1",
        "max_zoom": null,
        "s3_uri": null
      },
      {
        "status": "SUCCESS",
        "clipped": false,
        "url": "https://sentera-staging.s3.amazonaws.com/j0otAcmeOrg/izp6acz_AS_j0otAcmeOrg_CV_shar_cb973431_220810_124344/y9m3j8l_CO_j0otAcmeOrg_CV_shar_cb973431_220810_124351/Mosaics/v7uok1x_MO_j0otAcmeOrg_CV_shar_cb973431_220810_164531/cog_2390_h7rj8im_clipped.tif?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA4DTUCXGZGAJDWMIA%2F20220826%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20220826T155745Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=eeacbe7e335dae1e3c203af1ab45ba2d0d8b37c5646ee8b9b1354e38be53f1fb",
        "error": null,
        "max_zoom": 19,
        "s3_uri": "s3://blah",
        "bbox": [
          -93.5732606316094,
          44.60974795334748,
          -93.564692125167,
          44.617836771064844
        ]
      }
    ]
  }
  }
}

Mosaic by Sentera ID with Files

Retrieve a mosaic and its files

Try this example in GraphiQL
query RetrieveMosaicsWithFiles {
  mosaic(sentera_id: "itqkn28_MO_SHORT1_CV_test_dc0d87d_170907_235328") {
  sentera_id
  quality
  mosaic_type
  files {
    sentera_id
    path
    filename
    size
    url
    download_filename
  }
  }
}

{
  "data": {
  "mosaic": {
    "sentera_id": "itqkn28_MO_SHORT1_CV_test_dc0d87d_170907_235328",
    "quality": "quick",
    "mosaic_type": "RGB",
    "files": [
      {
        "sentera_id": "gbaxi33_FI_SHORT1_CV_test_dc0d87d_170907_235328",
        "path": "zx0tsts_AS_SHORT1_CV_test_1ba88e5_170907_220547Mosaicsitqkn28_MO_SHORT1_CV_test_dc0d87d_170907_235328",
        "filename": "QuickTileRGB_geotiff.tif",
        "size": 49776702,
        "url": "Pre-signed Amazon S3 URL",
        "download_filename": "itqkn28_QuickTileRGB_geotiff.tif"
      }
    ]
  }
  }
}