import_mosaic

Import a mosaic into a survey.

Input fields

additional_files ([FileImport!])

An array of FileImport objects specifying additional files to attach to the mosaic. Note that for each object, file_key and file_type are required, filename is optional, and all other arguments are ignored.

analytic_reference (MosaicAnalyticReference)

Reference to the analytic that is fulfilled through this mosaic. If this mosaic is not the result of an analytic order then do not provide.

bands ([MosaicBandInput!])

Information about the bands in this mosaic GeoTIFF.

deliverable_key (DeliverableKey)

The identifier for this type of mosaic when it is the deliverable on an order. Used by Sentera, not expected to be used by customers.

end_time (ISO8601DateTime)

End time of the survey. Required when creating a new survey.

field_sentera_id (ID)

ID of the field into which the new survey will be created. Required when creating a new survey.

file_keys ([FileKey!])

An array of file keys obtained via the create_file_upload or create_file_uploads mutation which represent the uploaded files.

files ([String!])
Deprecation notice

Please use file_keys instead

An array of file keys obtained via the create_file_upload or create_file_uploads mutation which represent the uploaded files.

mosaic_sentera_id (ID)

The Sentera ID of an existing mosaic into which you want to import a .tif file. If not specified then a new mosaic is created.

mosaic_type (MosaicImportType!)

The type of the mosaic.

multispectral_sensor_type (MultispectralSensorType)

The type of multispectral sensor used to capture the imagery. Required when mosaic_type is MULTISPECTRAL.

name (String)

The name of the mosaic. Optional unless mosaic_type is CUSTOM_INDEXED. A default name will be generated if not provided.

notify_user (Boolean)

Should the current user be notified when the mosaic has completed importing? Defaults to true.

order_reference (MosaicOrderReference)

Reference to the analytic that is fulfilled through this mosaic. If this mosaic is not the result of an analytic order then do not provide. Please use analytic_reference instead.

order_sentera_id (ID)
Deprecation notice

Please use analytic_reference instead

The ID of the analytic that is fulfilled through this mosaic. If not the result of an analytic do not provide.

quality (MosaicQuality!)

The quality indicator for this mosaic.

start_time (ISO8601DateTime)

Start time of the survey. Required when creating a new survey.

style_properties (MosaicStylePropertiesInput)

Style properties to be used when rendering a mosaic layer by a FieldAgent client.

survey_notes (String)

Notes used when creating a new survey.

survey_sentera_id (ID)

ID of the survey into which this mosaic will be imported. Required when importing into an existing survey.

Return fields

survey (Survey!)

The Survey that is created for the imported Mosaic.

Examples

Import Mosaic into a New Survey

Imports a mosaic into a new survey based on the ID of an uploaded file and other arguments.
The uploaded files must include at least one of type image/tiff.

Try this example in GraphiQL
mutation ImportMosaicIntoNewSurvey{
  import_mosaic(
  field_sentera_id: "fohqztc_AS_qw4gBigBird_CV_stag_456fd86_190318_191201"
  name: "My Mosaic"
  file_keys: ["eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBkUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a5bf542bb03268557328e65a30c8c36ea675e1a7"]
  mosaic_type: RGB
  quality: FULL
  start_time: "2020-01-22"
  end_time: "2020-01-23"
  survey_notes: "It was overcast the day I flew this field"
  ) {
  survey {
    sentera_id
  }
  }
}

{
  "data": {
  "import_mosaic": {
    "survey": {
      "sentera_id": "b9tq8b4_CO_cjweJakeOrg_CV_deve_586ed0e6_190319_104407"
    }
  }
  }
}

Import Mosaic into an Existing Survey

Imports a mosaic into an existing survey based on the ID of an uploaded file and other arguments.

Try this example in GraphiQL
mutation ImportMosaicIntoExistingSurvey{
  import_mosaic(
  survey_sentera_id: "me34ca_CO_qw4gBigBird_CV_stag_456fd86_190318_191201"
  name: "My Mosaic"
  file_keys: ["eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBkUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a5bf542bb03268557328e65a30c8c36ea675e1a7"]
  mosaic_type: RGB
  quality: FULL
  ) {
  survey {
    sentera_id
  }
  }
}

{
  "data": {
  "import_mosaic": {
    "survey": {
      "sentera_id": "me34ca_CO_qw4gBigBird_CV_stag_456fd86_190318_191201"
    }
  }
  }
}

Import Mosaic in Fulfillment of an Analytic

Imports a mosaic into a a survey and marks an associated analytic as fulfilled.

Try this example in GraphiQL
mutation ImportMosaic{
  import_mosaic(
  survey_sentera_id: "me34ca_CO_qw4gBigBird_CV_stag_456fd86_190318_191201"
  name: "My Mosaic"
  file_keys: ["eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBkUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a5bf542bb03268557328e65a30c8c36ea675e1a7"]
  mosaic_type: RGB
  quality: FULL
  analytic_reference: {
    analytic_sentera_id: "gkm2frg_AL_8y24BigBird_CV_stag_2efd705_210316_142625"
    mark_as_fulfilled: true
  }
  ) {
  survey {
    sentera_id
  }
  }
}

{
  "data": {
  "import_mosaic": {
    "survey": {
      "sentera_id": "me34ca_CO_qw4gBigBird_CV_stag_456fd86_190318_191201"
    }
  }
  }
}

Import Mosaic with Style Properties

Imports a mosaic with style properties used by a FieldAgent client to render the mosaic.

Try this example in GraphiQL
mutation ImportMosaicWithStyleProperties{
  import_mosaic(
  survey_sentera_id: "me34ca_CO_qw4gBigBird_CV_stag_456fd86_190318_191201"
  name: "My Mosaic"
  file_keys: ["eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBkUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a5bf542bb03268557328e65a30c8c36ea675e1a7"]
  mosaic_type: NDVI
  quality: FULL
  style_properties: {
    color_palette: ["beige", "burlywood", "#FFA500"]
    default_color_scale: BROWN_GREEN
    default_binning_algorithm: EQUAL_SPACING
    default_bin_count: 10
    invert_color_scale: true
    opacity: 0.75
  }
  ) {
  survey {
    sentera_id
  }
  }
}

{
  "data": {
  "import_mosaic": {
    "survey": {
      "sentera_id": "me34ca_CO_qw4gBigBird_CV_stag_456fd86_190318_191201"
    }
  }
  }
}

Import GeoTIFF into an Existing Mosaic

Imports a GeoTIFF file into an existing mosaic based on the ID of an uploaded file and other arguments.

Try this example in GraphiQL
mutation ImportGeoTIFFIntoExistingMosaic{
  import_mosaic(
  mosaic_sentera_id: "be34ca_MO_qw4gBigBird_CV_stag_456fd86_190318_191201"
  name: "My Mosaic"
  file_keys: ["eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBkUT09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a5bf542bb03268557328e65a30c8c36ea675e1a7"]
  mosaic_type: RGB
  quality: FULL
  ) {
  survey {
    sentera_id
  }
  }
}

{
  "data": {
  "import_mosaic": {
    "survey": {
      "sentera_id": "me34ca_CO_qw4gBigBird_CV_stag_456fd86_190318_191201"
    }
  }
  }
}