Amazon SageMaker geospatial capabilities

2022/11/30 - Amazon SageMaker geospatial capabilities - 19 new api methods

Changes  This release provides Amazon SageMaker geospatial APIs to build, train, deploy and visualize geospatial models.

ExportEarthObservationJob (new) Link ¶

Use this operation to export results of an Earth Observation job and optionally source images used as input to the EOJ to an S3 location.

See also: AWS API Documentation

Request Syntax

client.export_earth_observation_job(
    Arn='string',
    ExecutionRoleArn='string',
    ExportSourceImages=True|False,
    OutputConfig={
        'S3Data': {
            'KmsKeyId': 'string',
            'S3Uri': 'string'
        }
    }
)
type Arn:

string

param Arn:

[REQUIRED]

The input Amazon Resource Name (ARN) of the Earth Observation job being exported.

type ExecutionRoleArn:

string

param ExecutionRoleArn:

[REQUIRED]

The Amazon Resource Name (ARN) of the IAM role that you specified for the job.

type ExportSourceImages:

boolean

param ExportSourceImages:

The source images provided to the Earth Observation job being exported.

type OutputConfig:

dict

param OutputConfig:

[REQUIRED]

An object containing information about the output file.

  • S3Data (dict) -- [REQUIRED]

    Path to Amazon S3 storage location for the output configuration file.

    • KmsKeyId (string) --

      The Amazon Key Management Service (KMS) key ID for server-side encryption.

    • S3Uri (string) -- [REQUIRED]

      The URL to the Amazon S3 data input.

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'CreationTime': datetime(2015, 1, 1),
    'ExecutionRoleArn': 'string',
    'ExportSourceImages': True|False,
    'ExportStatus': 'IN_PROGRESS'|'SUCCEEDED'|'FAILED',
    'OutputConfig': {
        'S3Data': {
            'KmsKeyId': 'string',
            'S3Uri': 'string'
        }
    }
}

Response Structure

  • (dict) --

    • Arn (string) --

      The output Amazon Resource Name (ARN) of the Earth Observation job being exported.

    • CreationTime (datetime) --

      The creation time.

    • ExecutionRoleArn (string) --

      The Amazon Resource Name (ARN) of the IAM role that you specified for the job.

    • ExportSourceImages (boolean) --

      The source images provided to the Earth Observation job being exported.

    • ExportStatus (string) --

      The status of the results of the Earth Observation job being exported.

    • OutputConfig (dict) --

      An object containing information about the output file.

      • S3Data (dict) --

        Path to Amazon S3 storage location for the output configuration file.

        • KmsKeyId (string) --

          The Amazon Key Management Service (KMS) key ID for server-side encryption.

        • S3Uri (string) --

          The URL to the Amazon S3 data input.

DeleteVectorEnrichmentJob (new) Link ¶

Use this operation to delete a Vector Enrichment job.

See also: AWS API Documentation

Request Syntax

client.delete_vector_enrichment_job(
    Arn='string'
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the Vector Enrichment job being deleted.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

GetVectorEnrichmentJob (new) Link ¶

Retrieves details of a Vector Enrichment Job for a given job Amazon Resource Name (ARN).

See also: AWS API Documentation

Request Syntax

client.get_vector_enrichment_job(
    Arn='string'
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the Vector Enrichment job.

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'CreationTime': datetime(2015, 1, 1),
    'DurationInSeconds': 123,
    'ErrorDetails': {
        'ErrorMessage': 'string',
        'ErrorType': 'CLIENT_ERROR'|'SERVER_ERROR'
    },
    'ExecutionRoleArn': 'string',
    'ExportErrorDetails': {
        'Message': 'string',
        'Type': 'CLIENT_ERROR'|'SERVER_ERROR'
    },
    'ExportStatus': 'IN_PROGRESS'|'SUCCEEDED'|'FAILED',
    'InputConfig': {
        'DataSourceConfig': {
            'S3Data': {
                'KmsKeyId': 'string',
                'S3Uri': 'string'
            }
        },
        'DocumentType': 'CSV'
    },
    'JobConfig': {
        'MapMatchingConfig': {
            'IdAttributeName': 'string',
            'TimestampAttributeName': 'string',
            'XAttributeName': 'string',
            'YAttributeName': 'string'
        },
        'ReverseGeocodingConfig': {
            'XAttributeName': 'string',
            'YAttributeName': 'string'
        }
    },
    'KmsKeyId': 'string',
    'Name': 'string',
    'Status': 'INITIALIZING'|'IN_PROGRESS'|'STOPPING'|'STOPPED'|'COMPLETED'|'FAILED'|'DELETING'|'DELETED',
    'Tags': {
        'string': 'string'
    },
    'Type': 'REVERSE_GEOCODING'|'MAP_MATCHING'
}

Response Structure

  • (dict) --

    • Arn (string) --

      The Amazon Resource Name (ARN) of the Vector Enrichment job.

    • CreationTime (datetime) --

      The creation time.

    • DurationInSeconds (integer) --

      The duration of the Vector Enrichment job, in seconds.

    • ErrorDetails (dict) --

      Details about the errors generated during the Vector Enrichment job.

      • ErrorMessage (string) --

        A message that you define and then is processed and rendered by the Vector Enrichment job when the error occurs.

      • ErrorType (string) --

        The type of error generated during the Vector Enrichment job.

    • ExecutionRoleArn (string) --

      The Amazon Resource Name (ARN) of the IAM role that you specified for the job.

    • ExportErrorDetails (dict) --

      Details about the errors generated during the ExportVectorEnrichmentJob.

      • Message (string) --

        The message providing details about the errors generated during the Vector Enrichment job.

      • Type (string) --

    • ExportStatus (string) --

      The export status of the Vector Enrichment job being initiated.

    • InputConfig (dict) --

      Input configuration information for the Vector Enrichment job.

      • DataSourceConfig (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys will be set: S3Data. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        • S3Data (dict) --

          • KmsKeyId (string) --

            The Amazon Key Management Service (KMS) key ID for server-side encryption.

          • S3Uri (string) --

            The URL to the Amazon S3 data for the Vector Enrichment job.

      • DocumentType (string) --

    • JobConfig (dict) --

      An object containing information about the job configuration.

      • MapMatchingConfig (dict) --

        • IdAttributeName (string) --

        • TimestampAttributeName (string) --

          The name of the timestamp attribute.

        • XAttributeName (string) --

          The name of the X-attribute

        • YAttributeName (string) --

          The name of the Y-attribute

      • ReverseGeocodingConfig (dict) --

        • XAttributeName (string) --

        • YAttributeName (string) --

    • KmsKeyId (string) --

      The Amazon Key Management Service (KMS) key ID for server-side encryption.

    • Name (string) --

      The name of the Vector Enrichment job.

    • Status (string) --

      The status of the initiated Vector Enrichment job.

    • Tags (dict) --

      Each tag consists of a key and a value.

      • (string) --

        • (string) --

    • Type (string) --

      The type of the Vector Enrichment job being initiated.

GetRasterDataCollection (new) Link ¶

Use this operation to get details of a specific raster data collection.

See also: AWS API Documentation

Request Syntax

client.get_raster_data_collection(
    Arn='string'
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the raster data collection.

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'Description': 'string',
    'DescriptionPageUrl': 'string',
    'ImageSourceBands': [
        'string',
    ],
    'Name': 'string',
    'SupportedFilters': [
        {
            'Maximum': ...,
            'Minimum': ...,
            'Name': 'string',
            'Type': 'string'
        },
    ],
    'Tags': {
        'string': 'string'
    },
    'Type': 'PUBLIC'|'PREMIUM'|'USER'
}

Response Structure

  • (dict) --

    • Arn (string) --

      The Amazon Resource Name (ARN) of the raster data collection.

    • Description (string) --

      A description of the raster data collection.

    • DescriptionPageUrl (string) --

      The URL of the description page.

    • ImageSourceBands (list) --

      • (string) --

    • Name (string) --

      The name of the raster data collection.

    • SupportedFilters (list) --

      The filters supported by the raster data collection.

      • (dict) --

        The structure representing the filters supported by a RasterDataCollection.

        • Maximum (float) --

          The maximum value of the filter.

        • Minimum (float) --

          The minimum value of the filter.

        • Name (string) --

          The name of the filter.

        • Type (string) --

          The type of the filter being used.

    • Tags (dict) --

      Each tag consists of a key and a value.

      • (string) --

        • (string) --

    • Type (string) --

      The raster data collection type.

StartVectorEnrichmentJob (new) Link ¶

Creates a Vector Enrichment job for the supplied job type. Currently, there are two supported job types: reverse geocoding and map matching.

See also: AWS API Documentation

Request Syntax

client.start_vector_enrichment_job(
    ClientToken='string',
    ExecutionRoleArn='string',
    InputConfig={
        'DataSourceConfig': {
            'S3Data': {
                'KmsKeyId': 'string',
                'S3Uri': 'string'
            }
        },
        'DocumentType': 'CSV'
    },
    JobConfig={
        'MapMatchingConfig': {
            'IdAttributeName': 'string',
            'TimestampAttributeName': 'string',
            'XAttributeName': 'string',
            'YAttributeName': 'string'
        },
        'ReverseGeocodingConfig': {
            'XAttributeName': 'string',
            'YAttributeName': 'string'
        }
    },
    KmsKeyId='string',
    Name='string',
    Tags={
        'string': 'string'
    }
)
type ClientToken:

string

param ClientToken:

A unique token that guarantees that the call to this API is idempotent.

This field is autopopulated if not provided.

type ExecutionRoleArn:

string

param ExecutionRoleArn:

[REQUIRED]

The Amazon Resource Name (ARN) of the IAM role that you specified for the job.

type InputConfig:

dict

param InputConfig:

[REQUIRED]

Input configuration information for the Vector Enrichment job.

  • DataSourceConfig (dict) -- [REQUIRED] .. note:: This is a Tagged Union structure. Only one of the following top level keys can be set: S3Data.

    • S3Data (dict) --

      • KmsKeyId (string) --

        The Amazon Key Management Service (KMS) key ID for server-side encryption.

      • S3Uri (string) -- [REQUIRED]

        The URL to the Amazon S3 data for the Vector Enrichment job.

  • DocumentType (string) -- [REQUIRED]

type JobConfig:

dict

param JobConfig:

[REQUIRED]

An object containing information about the job configuration.

  • MapMatchingConfig (dict) --

    • IdAttributeName (string) -- [REQUIRED]

    • TimestampAttributeName (string) -- [REQUIRED]

      The name of the timestamp attribute.

    • XAttributeName (string) -- [REQUIRED]

      The name of the X-attribute

    • YAttributeName (string) -- [REQUIRED]

      The name of the Y-attribute

  • ReverseGeocodingConfig (dict) --

    • XAttributeName (string) -- [REQUIRED]

    • YAttributeName (string) -- [REQUIRED]

type KmsKeyId:

string

param KmsKeyId:

The Amazon Key Management Service (KMS) key ID for server-side encryption.

type Name:

string

param Name:

[REQUIRED]

The name of the Vector Enrichment job.

type Tags:

dict

param Tags:

Each tag consists of a key and a value.

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'CreationTime': datetime(2015, 1, 1),
    'DurationInSeconds': 123,
    'ExecutionRoleArn': 'string',
    'InputConfig': {
        'DataSourceConfig': {
            'S3Data': {
                'KmsKeyId': 'string',
                'S3Uri': 'string'
            }
        },
        'DocumentType': 'CSV'
    },
    'JobConfig': {
        'MapMatchingConfig': {
            'IdAttributeName': 'string',
            'TimestampAttributeName': 'string',
            'XAttributeName': 'string',
            'YAttributeName': 'string'
        },
        'ReverseGeocodingConfig': {
            'XAttributeName': 'string',
            'YAttributeName': 'string'
        }
    },
    'KmsKeyId': 'string',
    'Name': 'string',
    'Status': 'INITIALIZING'|'IN_PROGRESS'|'STOPPING'|'STOPPED'|'COMPLETED'|'FAILED'|'DELETING'|'DELETED',
    'Tags': {
        'string': 'string'
    },
    'Type': 'REVERSE_GEOCODING'|'MAP_MATCHING'
}

Response Structure

  • (dict) --

    • Arn (string) --

      The Amazon Resource Name (ARN) of the Vector Enrichment job.

    • CreationTime (datetime) --

      The creation time.

    • DurationInSeconds (integer) --

      The duration of the Vector Enrichment job, in seconds.

    • ExecutionRoleArn (string) --

      The Amazon Resource Name (ARN) of the IAM role that you specified for the job.

    • InputConfig (dict) --

      Input configuration information for starting the Vector Enrichment job.

      • DataSourceConfig (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys will be set: S3Data. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        • S3Data (dict) --

          • KmsKeyId (string) --

            The Amazon Key Management Service (KMS) key ID for server-side encryption.

          • S3Uri (string) --

            The URL to the Amazon S3 data for the Vector Enrichment job.

      • DocumentType (string) --

    • JobConfig (dict) --

      An object containing information about the job configuration.

      • MapMatchingConfig (dict) --

        • IdAttributeName (string) --

        • TimestampAttributeName (string) --

          The name of the timestamp attribute.

        • XAttributeName (string) --

          The name of the X-attribute

        • YAttributeName (string) --

          The name of the Y-attribute

      • ReverseGeocodingConfig (dict) --

        • XAttributeName (string) --

        • YAttributeName (string) --

    • KmsKeyId (string) --

      The Amazon Key Management Service (KMS) key ID for server-side encryption.

    • Name (string) --

      The name of the Vector Enrichment job.

    • Status (string) --

      The status of the Vector Enrichment job being started.

    • Tags (dict) --

      Each tag consists of a key and a value.

      • (string) --

        • (string) --

    • Type (string) --

      The type of the Vector Enrichment job.

SearchRasterDataCollection (new) Link ¶

Allows you run image query on a specific raster data collection to get a list of the satellite imagery matching the selected filters.

See also: AWS API Documentation

Request Syntax

client.search_raster_data_collection(
    Arn='string',
    NextToken='string',
    RasterDataCollectionQuery={
        'AreaOfInterest': {
            'AreaOfInterestGeometry': {
                'MultiPolygonGeometry': {
                    'Coordinates': [
                        [
                            [
                                [
                                    123.0,
                                ],
                            ],
                        ],
                    ]
                },
                'PolygonGeometry': {
                    'Coordinates': [
                        [
                            [
                                123.0,
                            ],
                        ],
                    ]
                }
            }
        },
        'BandFilter': [
            'string',
        ],
        'PropertyFilters': {
            'LogicalOperator': 'AND',
            'Properties': [
                {
                    'Property': {
                        'EoCloudCover': {
                            'LowerBound': ...,
                            'UpperBound': ...
                        },
                        'LandsatCloudCoverLand': {
                            'LowerBound': ...,
                            'UpperBound': ...
                        },
                        'Platform': {
                            'ComparisonOperator': 'EQUALS'|'NOT_EQUALS'|'STARTS_WITH',
                            'Value': 'string'
                        },
                        'ViewOffNadir': {
                            'LowerBound': ...,
                            'UpperBound': ...
                        },
                        'ViewSunAzimuth': {
                            'LowerBound': ...,
                            'UpperBound': ...
                        },
                        'ViewSunElevation': {
                            'LowerBound': ...,
                            'UpperBound': ...
                        }
                    }
                },
            ]
        },
        'TimeRangeFilter': {
            'EndTime': datetime(2015, 1, 1),
            'StartTime': datetime(2015, 1, 1)
        }
    }
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the raster data collection.

type NextToken:

string

param NextToken:

If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

type RasterDataCollectionQuery:

dict

param RasterDataCollectionQuery:

[REQUIRED]

  • AreaOfInterest (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys can be set: AreaOfInterestGeometry.

    • AreaOfInterestGeometry (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys can be set: MultiPolygonGeometry, PolygonGeometry.

      • MultiPolygonGeometry (dict) --

        • Coordinates (list) -- [REQUIRED]

          The coordinates of the multipolygon geometry.

          • (list) --

            • (list) --

              • (list) --

                • (float) --

      • PolygonGeometry (dict) --

        • Coordinates (list) -- [REQUIRED]

          • (list) --

            • (list) --

              • (float) --

  • BandFilter (list) --

    • (string) --

  • PropertyFilters (dict) --

    • LogicalOperator (string) --

    • Properties (list) --

      • (dict) --

        • Property (dict) -- [REQUIRED] .. note:: This is a Tagged Union structure. Only one of the following top level keys can be set: EoCloudCover, LandsatCloudCoverLand, Platform, ViewOffNadir, ViewSunAzimuth, ViewSunElevation.

          • EoCloudCover (dict) --

            • LowerBound (float) -- [REQUIRED]

            • UpperBound (float) -- [REQUIRED]

          • LandsatCloudCoverLand (dict) --

            • LowerBound (float) -- [REQUIRED]

            • UpperBound (float) -- [REQUIRED]

          • Platform (dict) --

            • ComparisonOperator (string) --

            • Value (string) -- [REQUIRED]

              The value of the platform.

          • ViewOffNadir (dict) --

            • LowerBound (float) -- [REQUIRED]

            • UpperBound (float) -- [REQUIRED]

          • ViewSunAzimuth (dict) --

            • LowerBound (float) -- [REQUIRED]

            • UpperBound (float) -- [REQUIRED]

          • ViewSunElevation (dict) --

            • LowerBound (float) -- [REQUIRED]

              The lower bound to view the sun elevation.

            • UpperBound (float) -- [REQUIRED]

              The upper bound to view the sun elevation.

  • TimeRangeFilter (dict) -- [REQUIRED]

    • EndTime (datetime) -- [REQUIRED]

      The end time for the time-range filter.

    • StartTime (datetime) -- [REQUIRED]

      The start time for the time-range filter.

rtype:

dict

returns:

Response Syntax

{
    'ApproximateResultCount': 123,
    'Items': [
        {
            'Assets': {
                'string': {
                    'Href': 'string'
                }
            },
            'DateTime': datetime(2015, 1, 1),
            'Geometry': {
                'Coordinates': [
                    [
                        [
                            123.0,
                        ],
                    ],
                ],
                'Type': 'string'
            },
            'Id': 'string',
            'Properties': {
                'EoCloudCover': ...,
                'LandsatCloudCoverLand': ...,
                'Platform': 'string',
                'ViewOffNadir': ...,
                'ViewSunAzimuth': ...,
                'ViewSunElevation': ...
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • ApproximateResultCount (integer) --

    • Items (list) --

      • (dict) --

        Structure representing the items in the response for SearchRasterDataCollection.

        • Assets (dict) --

          • (string) --

            • (dict) --

              • Href (string) --

        • DateTime (datetime) --

        • Geometry (dict) --

          • Coordinates (list) --

            • (list) --

              • (list) --

                • (float) --

          • Type (string) --

        • Id (string) --

          A unique Id for the source item.

        • Properties (dict) --

          • EoCloudCover (float) --

          • LandsatCloudCoverLand (float) --

          • Platform (string) --

          • ViewOffNadir (float) --

          • ViewSunAzimuth (float) --

          • ViewSunElevation (float) --

    • NextToken (string) --

      If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

ListRasterDataCollections (new) Link ¶

Use this operation to get raster data collections.

See also: AWS API Documentation

Request Syntax

client.list_raster_data_collections(
    MaxResults=123,
    NextToken='string'
)
type MaxResults:

integer

param MaxResults:

The total number of items to return.

type NextToken:

string

param NextToken:

If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

rtype:

dict

returns:

Response Syntax

{
    'NextToken': 'string',
    'RasterDataCollectionSummaries': [
        {
            'Arn': 'string',
            'Description': 'string',
            'DescriptionPageUrl': 'string',
            'Name': 'string',
            'SupportedFilters': [
                {
                    'Maximum': ...,
                    'Minimum': ...,
                    'Name': 'string',
                    'Type': 'string'
                },
            ],
            'Tags': {
                'string': 'string'
            },
            'Type': 'PUBLIC'|'PREMIUM'|'USER'
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

    • RasterDataCollectionSummaries (list) --

      Contains summary information about the raster data collection.

      • (dict) --

        Response object containing details for a specific RasterDataCollection.

        • Arn (string) --

          The Amazon Resource Name (ARN) of the raster data collection.

        • Description (string) --

          A description of the raster data collection.

        • DescriptionPageUrl (string) --

          The description URL of the raster data collection.

        • Name (string) --

          The name of the raster data collection.

        • SupportedFilters (list) --

          • (dict) --

            The structure representing the filters supported by a RasterDataCollection.

            • Maximum (float) --

              The maximum value of the filter.

            • Minimum (float) --

              The minimum value of the filter.

            • Name (string) --

              The name of the filter.

            • Type (string) --

              The type of the filter being used.

        • Tags (dict) --

          Each tag consists of a key and a value.

          • (string) --

            • (string) --

        • Type (string) --

          The type of raster data collection.

ListVectorEnrichmentJobs (new) Link ¶

Retrieves a list of vector enrichment jobs.

See also: AWS API Documentation

Request Syntax

client.list_vector_enrichment_jobs(
    MaxResults=123,
    NextToken='string',
    SortBy='string',
    SortOrder='ASCENDING'|'DESCENDING',
    StatusEquals='string'
)
type MaxResults:

integer

param MaxResults:

The maximum number of items to return.

type NextToken:

string

param NextToken:

If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

type SortBy:

string

param SortBy:

The parameter by which to sort the results.

type SortOrder:

string

param SortOrder:

An optional value that specifies whether you want the results sorted in Ascending or Descending order.

type StatusEquals:

string

param StatusEquals:

A filter that retrieves only jobs with a specific status.

rtype:

dict

returns:

Response Syntax

{
    'NextToken': 'string',
    'VectorEnrichmentJobSummaries': [
        {
            'Arn': 'string',
            'CreationTime': datetime(2015, 1, 1),
            'DurationInSeconds': 123,
            'Name': 'string',
            'Status': 'INITIALIZING'|'IN_PROGRESS'|'STOPPING'|'STOPPED'|'COMPLETED'|'FAILED'|'DELETING'|'DELETED',
            'Tags': {
                'string': 'string'
            },
            'Type': 'REVERSE_GEOCODING'|'MAP_MATCHING'
        },
    ]
}

Response Structure

  • (dict) --

    • NextToken (string) --

      If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

    • VectorEnrichmentJobSummaries (list) --

      Contains summary information about the Vector Enrichment jobs.

      • (dict) --

        An object containing information about the output file.

        • Arn (string) --

          The Amazon Resource Name (ARN) of the list of the Vector Enrichment jobs.

        • CreationTime (datetime) --

          The creation time.

        • DurationInSeconds (integer) --

          The duration of the session, in seconds.

        • Name (string) --

          The names of the Vector Enrichment jobs in the list.

        • Status (string) --

          The status of the Vector Enrichment jobs list.

        • Tags (dict) --

          Each tag consists of a key and a value.

          • (string) --

            • (string) --

        • Type (string) --

          The type of the list of Vector Enrichment jobs.

GetTile (new) Link ¶

Gets a web mercator tile for the given Earth Observation job.

See also: AWS API Documentation

Request Syntax

client.get_tile(
    Arn='string',
    ImageAssets=[
        'string',
    ],
    ImageMask=True|False,
    OutputDataType='INT32'|'FLOAT32'|'INT16'|'FLOAT64'|'UINT16',
    OutputFormat='string',
    PropertyFilters='string',
    Target='INPUT'|'OUTPUT',
    TimeRangeFilter='string',
    x=123,
    y=123,
    z=123
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the tile operation.

type ImageAssets:

list

param ImageAssets:

[REQUIRED]

The particular assets or bands to tile.

  • (string) --

type ImageMask:

boolean

param ImageMask:

Determines whether or not to return a valid data mask.

type OutputDataType:

string

param OutputDataType:

The output data type of the tile operation.

type OutputFormat:

string

param OutputFormat:

The data format of the output tile. The formats include .npy, .png and .jpg.

type PropertyFilters:

string

param PropertyFilters:

Property filters for the imagery to tile.

type Target:

string

param Target:

[REQUIRED]

Determines what part of the Earth Observation job to tile. 'INPUT' or 'OUTPUT' are the valid options.

type TimeRangeFilter:

string

param TimeRangeFilter:

Time range filter applied to imagery to find the images to tile.

type x:

integer

param x:

[REQUIRED]

The x coordinate of the tile input.

type y:

integer

param y:

[REQUIRED]

The y coordinate of the tile input.

type z:

integer

param z:

[REQUIRED]

The z coordinate of the tile input.

rtype:

dict

returns:

Response Syntax

{
    'BinaryFile': StreamingBody()
}

Response Structure

  • (dict) --

    • BinaryFile (:class:`.StreamingBody`) --

      The output binary file.

TagResource (new) Link ¶

The resource you want to tag.

See also: AWS API Documentation

Request Syntax

client.tag_resource(
    ResourceArn='string',
    Tags={
        'string': 'string'
    }
)
type ResourceArn:

string

param ResourceArn:

[REQUIRED]

The Amazon Resource Name (ARN) of the resource you want to tag.

type Tags:

dict

param Tags:

[REQUIRED]

Each tag consists of a key and a value.

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

ListEarthObservationJobs (new) Link ¶

Use this operation to get a list of the Earth Observation jobs associated with the calling Amazon Web Services account.

See also: AWS API Documentation

Request Syntax

client.list_earth_observation_jobs(
    MaxResults=123,
    NextToken='string',
    SortBy='string',
    SortOrder='ASCENDING'|'DESCENDING',
    StatusEquals='INITIALIZING'|'IN_PROGRESS'|'STOPPING'|'COMPLETED'|'STOPPED'|'FAILED'|'DELETING'|'DELETED'
)
type MaxResults:

integer

param MaxResults:

The total number of items to return.

type NextToken:

string

param NextToken:

If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

type SortBy:

string

param SortBy:

The parameter by which to sort the results.

type SortOrder:

string

param SortOrder:

An optional value that specifies whether you want the results sorted in Ascending or Descending order.

type StatusEquals:

string

param StatusEquals:

A filter that retrieves only jobs with a specific status.

rtype:

dict

returns:

Response Syntax

{
    'EarthObservationJobSummaries': [
        {
            'Arn': 'string',
            'CreationTime': datetime(2015, 1, 1),
            'DurationInSeconds': 123,
            'Name': 'string',
            'OperationType': 'string',
            'Status': 'INITIALIZING'|'IN_PROGRESS'|'STOPPING'|'COMPLETED'|'STOPPED'|'FAILED'|'DELETING'|'DELETED',
            'Tags': {
                'string': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • EarthObservationJobSummaries (list) --

      Contains summary information about the Earth Observation jobs.

      • (dict) --

        An object containing information about the output file.

        • Arn (string) --

          The Amazon Resource Name (ARN) of the list of the Earth Observation jobs.

        • CreationTime (datetime) --

          The creation time.

        • DurationInSeconds (integer) --

          The duration of the session, in seconds.

        • Name (string) --

          The names of the Earth Observation jobs in the list.

        • OperationType (string) --

        • Status (string) --

          The status of the list of the Earth Observation jobs.

        • Tags (dict) --

          Each tag consists of a key and a value.

          • (string) --

            • (string) --

    • NextToken (string) --

      If the previous response was truncated, you receive this token. Use it in your next request to receive the next set of results.

StopEarthObservationJob (new) Link ¶

Use this operation to stop an existing earth observation job.

See also: AWS API Documentation

Request Syntax

client.stop_earth_observation_job(
    Arn='string'
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the Earth Observation job being stopped.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

ExportVectorEnrichmentJob (new) Link ¶

Use this operation to copy results of a Vector Enrichment job to an S3 location.

See also: AWS API Documentation

Request Syntax

client.export_vector_enrichment_job(
    Arn='string',
    ExecutionRoleArn='string',
    OutputConfig={
        'S3Data': {
            'KmsKeyId': 'string',
            'S3Uri': 'string'
        }
    }
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the Vector Enrichment job.

type ExecutionRoleArn:

string

param ExecutionRoleArn:

[REQUIRED]

The Amazon Resource Name (ARN) of the IAM rolewith permission to upload to the location in OutputConfig.

type OutputConfig:

dict

param OutputConfig:

[REQUIRED]

Output location information for exporting Vector Enrichment Job results.

  • S3Data (dict) -- [REQUIRED]

    • KmsKeyId (string) --

      The Amazon Key Management Service (KMS) key ID for server-side encryption.

    • S3Uri (string) -- [REQUIRED]

      The URL to the Amazon S3 data for the Vector Enrichment job.

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'CreationTime': datetime(2015, 1, 1),
    'ExecutionRoleArn': 'string',
    'ExportStatus': 'IN_PROGRESS'|'SUCCEEDED'|'FAILED',
    'OutputConfig': {
        'S3Data': {
            'KmsKeyId': 'string',
            'S3Uri': 'string'
        }
    }
}

Response Structure

  • (dict) --

    • Arn (string) --

      The Amazon Resource Name (ARN) of the Vector Enrichment job being exported.

    • CreationTime (datetime) --

      The creation time.

    • ExecutionRoleArn (string) --

      The Amazon Resource Name (ARN) of the IAM role with permission to upload to the location in OutputConfig.

    • ExportStatus (string) --

      The status of the results the Vector Enrichment job being exported.

    • OutputConfig (dict) --

      Output location information for exporting Vector Enrichment Job results.

      • S3Data (dict) --

        • KmsKeyId (string) --

          The Amazon Key Management Service (KMS) key ID for server-side encryption.

        • S3Uri (string) --

          The URL to the Amazon S3 data for the Vector Enrichment job.

StartEarthObservationJob (new) Link ¶

Use this operation to create an Earth observation job.

See also: AWS API Documentation

Request Syntax

client.start_earth_observation_job(
    ClientToken='string',
    ExecutionRoleArn='string',
    InputConfig={
        'DataSourceConfig': {
            'S3Data': {
                'KmsKeyId': 'string',
                'MetadataProvider': 'PLANET_ORDER',
                'S3Uri': 'string'
            }
        },
        'PreviousEarthObservationJobArn': 'string',
        'RasterDataCollectionQuery': {
            'AreaOfInterest': {
                'AreaOfInterestGeometry': {
                    'MultiPolygonGeometry': {
                        'Coordinates': [
                            [
                                [
                                    [
                                        123.0,
                                    ],
                                ],
                            ],
                        ]
                    },
                    'PolygonGeometry': {
                        'Coordinates': [
                            [
                                [
                                    123.0,
                                ],
                            ],
                        ]
                    }
                }
            },
            'PropertyFilters': {
                'LogicalOperator': 'AND',
                'Properties': [
                    {
                        'Property': {
                            'EoCloudCover': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'LandsatCloudCoverLand': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'Platform': {
                                'ComparisonOperator': 'EQUALS'|'NOT_EQUALS'|'STARTS_WITH',
                                'Value': 'string'
                            },
                            'ViewOffNadir': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'ViewSunAzimuth': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'ViewSunElevation': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            }
                        }
                    },
                ]
            },
            'RasterDataCollectionArn': 'string',
            'TimeRangeFilter': {
                'EndTime': datetime(2015, 1, 1),
                'StartTime': datetime(2015, 1, 1)
            }
        }
    },
    JobConfig={
        'BandMathConfig': {
            'CustomIndices': {
                'Operations': [
                    {
                        'Equation': 'string',
                        'Name': 'string',
                        'OutputType': 'INT32'|'FLOAT32'|'INT16'|'FLOAT64'|'UINT16'
                    },
                ]
            },
            'PredefinedIndices': [
                'string',
            ]
        },
        'CloudMaskingConfig': {}
        ,
        'CloudRemovalConfig': {
            'AlgorithmName': 'INTERPOLATION',
            'InterpolationValue': 'string',
            'TargetBands': [
                'string',
            ]
        },
        'GeoMosaicConfig': {
            'AlgorithmName': 'NEAR'|'BILINEAR'|'CUBIC'|'CUBICSPLINE'|'LANCZOS'|'AVERAGE'|'RMS'|'MODE'|'MAX'|'MIN'|'MED'|'Q1'|'Q3'|'SUM',
            'TargetBands': [
                'string',
            ]
        },
        'LandCoverSegmentationConfig': {}
        ,
        'ResamplingConfig': {
            'AlgorithmName': 'NEAR'|'BILINEAR'|'CUBIC'|'CUBICSPLINE'|'LANCZOS'|'AVERAGE'|'RMS'|'MODE'|'MAX'|'MIN'|'MED'|'Q1'|'Q3'|'SUM',
            'OutputResolution': {
                'UserDefined': {
                    'Unit': 'METERS',
                    'Value': ...
                }
            },
            'TargetBands': [
                'string',
            ]
        },
        'StackConfig': {
            'OutputResolution': {
                'Predefined': 'HIGHEST'|'LOWEST'|'AVERAGE',
                'UserDefined': {
                    'Unit': 'METERS',
                    'Value': ...
                }
            },
            'TargetBands': [
                'string',
            ]
        },
        'TemporalStatisticsConfig': {
            'GroupBy': 'ALL'|'YEARLY',
            'Statistics': [
                'MEAN'|'MEDIAN'|'STANDARD_DEVIATION',
            ],
            'TargetBands': [
                'string',
            ]
        },
        'ZonalStatisticsConfig': {
            'Statistics': [
                'MEAN'|'MEDIAN'|'STANDARD_DEVIATION'|'MAX'|'MIN'|'SUM',
            ],
            'TargetBands': [
                'string',
            ],
            'ZoneS3Path': 'string'
        }
    },
    KmsKeyId='string',
    Name='string',
    Tags={
        'string': 'string'
    }
)
type ClientToken:

string

param ClientToken:

A unique token that guarantees that the call to this API is idempotent.

This field is autopopulated if not provided.

type ExecutionRoleArn:

string

param ExecutionRoleArn:

The Amazon Resource Name (ARN) of the IAM role that you specified for the job.

type InputConfig:

dict

param InputConfig:

[REQUIRED]

Input configuration information for the Earth Observation job.

  • DataSourceConfig (dict) --

    The location of the input data.>

    • S3Data (dict) --

      • KmsKeyId (string) --

        The Amazon Key Management Service (KMS) key ID for server-side encryption.

      • MetadataProvider (string) -- [REQUIRED]

      • S3Uri (string) -- [REQUIRED]

        The URL to the Amazon S3 input.

  • PreviousEarthObservationJobArn (string) --

    The Amazon Resource Name (ARN) of the previous Earth Observation job.

  • RasterDataCollectionQuery (dict) --

    • AreaOfInterest (dict) --

      The area of interest being queried for the raster data collection.

      • AreaOfInterestGeometry (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys can be set: MultiPolygonGeometry, PolygonGeometry.

        • MultiPolygonGeometry (dict) --

          • Coordinates (list) -- [REQUIRED]

            The coordinates of the multipolygon geometry.

            • (list) --

              • (list) --

                • (list) --

                  • (float) --

        • PolygonGeometry (dict) --

          • Coordinates (list) -- [REQUIRED]

            • (list) --

              • (list) --

                • (float) --

    • PropertyFilters (dict) --

      • LogicalOperator (string) --

      • Properties (list) --

        • (dict) --

          • Property (dict) -- [REQUIRED] .. note:: This is a Tagged Union structure. Only one of the following top level keys can be set: EoCloudCover, LandsatCloudCoverLand, Platform, ViewOffNadir, ViewSunAzimuth, ViewSunElevation.

            • EoCloudCover (dict) --

              • LowerBound (float) -- [REQUIRED]

              • UpperBound (float) -- [REQUIRED]

            • LandsatCloudCoverLand (dict) --

              • LowerBound (float) -- [REQUIRED]

              • UpperBound (float) -- [REQUIRED]

            • Platform (dict) --

              • ComparisonOperator (string) --

              • Value (string) -- [REQUIRED]

                The value of the platform.

            • ViewOffNadir (dict) --

              • LowerBound (float) -- [REQUIRED]

              • UpperBound (float) -- [REQUIRED]

            • ViewSunAzimuth (dict) --

              • LowerBound (float) -- [REQUIRED]

              • UpperBound (float) -- [REQUIRED]

            • ViewSunElevation (dict) --

              • LowerBound (float) -- [REQUIRED]

                The lower bound to view the sun elevation.

              • UpperBound (float) -- [REQUIRED]

                The upper bound to view the sun elevation.

    • RasterDataCollectionArn (string) -- [REQUIRED]

      The Amazon Resource Name (ARN) of the raster data collection.

    • TimeRangeFilter (dict) -- [REQUIRED]

      • EndTime (datetime) -- [REQUIRED]

        The end time for the time-range filter.

      • StartTime (datetime) -- [REQUIRED]

        The start time for the time-range filter.

type JobConfig:

dict

param JobConfig:

[REQUIRED]

An object containing information about the job configuration.

  • BandMathConfig (dict) --

    • CustomIndices (dict) --

      • Operations (list) --

        • (dict) --

          • Equation (string) -- [REQUIRED]

          • Name (string) -- [REQUIRED]

            The name of the operation.

          • OutputType (string) --

            The type of the operation.

    • PredefinedIndices (list) --

      • (string) --

  • CloudMaskingConfig (dict) --

    An object containing information about the job configuration for cloud masking.

  • CloudRemovalConfig (dict) --

    An object containing information about the job configuration for cloud removal.

    • AlgorithmName (string) --

      The name of the algorithm used for cloud removal.

    • InterpolationValue (string) --

      The interpolation value you provide for cloud removal.

    • TargetBands (list) --

      • (string) --

  • GeoMosaicConfig (dict) --

    An object containing information about the job configuration for geomosaic.

    • AlgorithmName (string) --

      The name of the algorithm being used for geomosaic.

    • TargetBands (list) --

      The target bands for geomosaic.

      • (string) --

  • LandCoverSegmentationConfig (dict) --

    An object containing information about the job configuration for land cover segmentation.

  • ResamplingConfig (dict) --

    An object containing information about the job configuration for resampling.

    • AlgorithmName (string) --

      The name of the algorithm used for resampling.

    • OutputResolution (dict) -- [REQUIRED]

      • UserDefined (dict) -- [REQUIRED]

        • Unit (string) -- [REQUIRED]

        • Value (float) -- [REQUIRED]

    • TargetBands (list) --

      • (string) --

  • StackConfig (dict) --

    • OutputResolution (dict) --

      • Predefined (string) --

      • UserDefined (dict) --

        • Unit (string) -- [REQUIRED]

        • Value (float) -- [REQUIRED]

    • TargetBands (list) --

      • (string) --

  • TemporalStatisticsConfig (dict) --

    An object containing information about the job configuration for temporal statistics.

    • GroupBy (string) --

    • Statistics (list) -- [REQUIRED]

      • (string) --

    • TargetBands (list) --

      • (string) --

  • ZonalStatisticsConfig (dict) --

    An object containing information about the job configuration for zonal statistics.

    • Statistics (list) -- [REQUIRED]

      • (string) --

    • TargetBands (list) --

      • (string) --

    • ZoneS3Path (string) -- [REQUIRED]

type KmsKeyId:

string

param KmsKeyId:

The Amazon Key Management Service (KMS) key ID for server-side encryption.

type Name:

string

param Name:

[REQUIRED]

The name of the Earth Observation job.

type Tags:

dict

param Tags:

Each tag consists of a key and a value.

  • (string) --

    • (string) --

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'CreationTime': datetime(2015, 1, 1),
    'DurationInSeconds': 123,
    'ExecutionRoleArn': 'string',
    'InputConfig': {
        'DataSourceConfig': {
            'S3Data': {
                'KmsKeyId': 'string',
                'MetadataProvider': 'PLANET_ORDER',
                'S3Uri': 'string'
            }
        },
        'PreviousEarthObservationJobArn': 'string',
        'RasterDataCollectionQuery': {
            'AreaOfInterest': {
                'AreaOfInterestGeometry': {
                    'MultiPolygonGeometry': {
                        'Coordinates': [
                            [
                                [
                                    [
                                        123.0,
                                    ],
                                ],
                            ],
                        ]
                    },
                    'PolygonGeometry': {
                        'Coordinates': [
                            [
                                [
                                    123.0,
                                ],
                            ],
                        ]
                    }
                }
            },
            'PropertyFilters': {
                'LogicalOperator': 'AND',
                'Properties': [
                    {
                        'Property': {
                            'EoCloudCover': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'LandsatCloudCoverLand': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'Platform': {
                                'ComparisonOperator': 'EQUALS'|'NOT_EQUALS'|'STARTS_WITH',
                                'Value': 'string'
                            },
                            'ViewOffNadir': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'ViewSunAzimuth': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'ViewSunElevation': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            }
                        }
                    },
                ]
            },
            'RasterDataCollectionArn': 'string',
            'RasterDataCollectionName': 'string',
            'TimeRangeFilter': {
                'EndTime': datetime(2015, 1, 1),
                'StartTime': datetime(2015, 1, 1)
            }
        }
    },
    'JobConfig': {
        'BandMathConfig': {
            'CustomIndices': {
                'Operations': [
                    {
                        'Equation': 'string',
                        'Name': 'string',
                        'OutputType': 'INT32'|'FLOAT32'|'INT16'|'FLOAT64'|'UINT16'
                    },
                ]
            },
            'PredefinedIndices': [
                'string',
            ]
        },
        'CloudMaskingConfig': {},
        'CloudRemovalConfig': {
            'AlgorithmName': 'INTERPOLATION',
            'InterpolationValue': 'string',
            'TargetBands': [
                'string',
            ]
        },
        'GeoMosaicConfig': {
            'AlgorithmName': 'NEAR'|'BILINEAR'|'CUBIC'|'CUBICSPLINE'|'LANCZOS'|'AVERAGE'|'RMS'|'MODE'|'MAX'|'MIN'|'MED'|'Q1'|'Q3'|'SUM',
            'TargetBands': [
                'string',
            ]
        },
        'LandCoverSegmentationConfig': {},
        'ResamplingConfig': {
            'AlgorithmName': 'NEAR'|'BILINEAR'|'CUBIC'|'CUBICSPLINE'|'LANCZOS'|'AVERAGE'|'RMS'|'MODE'|'MAX'|'MIN'|'MED'|'Q1'|'Q3'|'SUM',
            'OutputResolution': {
                'UserDefined': {
                    'Unit': 'METERS',
                    'Value': ...
                }
            },
            'TargetBands': [
                'string',
            ]
        },
        'StackConfig': {
            'OutputResolution': {
                'Predefined': 'HIGHEST'|'LOWEST'|'AVERAGE',
                'UserDefined': {
                    'Unit': 'METERS',
                    'Value': ...
                }
            },
            'TargetBands': [
                'string',
            ]
        },
        'TemporalStatisticsConfig': {
            'GroupBy': 'ALL'|'YEARLY',
            'Statistics': [
                'MEAN'|'MEDIAN'|'STANDARD_DEVIATION',
            ],
            'TargetBands': [
                'string',
            ]
        },
        'ZonalStatisticsConfig': {
            'Statistics': [
                'MEAN'|'MEDIAN'|'STANDARD_DEVIATION'|'MAX'|'MIN'|'SUM',
            ],
            'TargetBands': [
                'string',
            ],
            'ZoneS3Path': 'string'
        }
    },
    'KmsKeyId': 'string',
    'Name': 'string',
    'Status': 'INITIALIZING'|'IN_PROGRESS'|'STOPPING'|'COMPLETED'|'STOPPED'|'FAILED'|'DELETING'|'DELETED',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • Arn (string) --

      The Amazon Resource Name (ARN) of the Earth Observation job.

    • CreationTime (datetime) --

      The creation time.

    • DurationInSeconds (integer) --

      The duration of the session, in seconds.

    • ExecutionRoleArn (string) --

      The Amazon Resource Name (ARN) of the IAM role that you specified for the job.

    • InputConfig (dict) --

      Input configuration information for the Earth Observation job.

      • DataSourceConfig (dict) --

        The location of the input data.

        • S3Data (dict) --

          • KmsKeyId (string) --

            The Amazon Key Management Service (KMS) key ID for server-side encryption.

          • MetadataProvider (string) --

          • S3Uri (string) --

            The URL to the Amazon S3 input.

      • PreviousEarthObservationJobArn (string) --

        The Amazon Resource Name (ARN) of the previous Earth Observation job.

      • RasterDataCollectionQuery (dict) --

        • AreaOfInterest (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys will be set: AreaOfInterestGeometry. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          • AreaOfInterestGeometry (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys will be set: MultiPolygonGeometry, PolygonGeometry. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

            'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
            • MultiPolygonGeometry (dict) --

              • Coordinates (list) --

                The coordinates of the multipolygon geometry.

                • (list) --

                  • (list) --

                    • (list) --

                      • (float) --

            • PolygonGeometry (dict) --

              • Coordinates (list) --

                • (list) --

                  • (list) --

                    • (float) --

        • PropertyFilters (dict) --

          • LogicalOperator (string) --

          • Properties (list) --

            • (dict) --

              • Property (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys will be set: EoCloudCover, LandsatCloudCoverLand, Platform, ViewOffNadir, ViewSunAzimuth, ViewSunElevation. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

                'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
                • EoCloudCover (dict) --

                  • LowerBound (float) --

                  • UpperBound (float) --

                • LandsatCloudCoverLand (dict) --

                  • LowerBound (float) --

                  • UpperBound (float) --

                • Platform (dict) --

                  • ComparisonOperator (string) --

                  • Value (string) --

                    The value of the platform.

                • ViewOffNadir (dict) --

                  • LowerBound (float) --

                  • UpperBound (float) --

                • ViewSunAzimuth (dict) --

                  • LowerBound (float) --

                  • UpperBound (float) --

                • ViewSunElevation (dict) --

                  • LowerBound (float) --

                    The lower bound to view the sun elevation.

                  • UpperBound (float) --

                    The upper bound to view the sun elevation.

        • RasterDataCollectionArn (string) --

        • RasterDataCollectionName (string) --

          The name of the raster data collection.

        • TimeRangeFilter (dict) --

          • EndTime (datetime) --

            The end time for the time-range filter.

          • StartTime (datetime) --

            The start time for the time-range filter.

    • JobConfig (dict) --

      An object containing information about the job configuration.

      • BandMathConfig (dict) --

        • CustomIndices (dict) --

          • Operations (list) --

            • (dict) --

              • Equation (string) --

              • Name (string) --

                The name of the operation.

              • OutputType (string) --

                The type of the operation.

        • PredefinedIndices (list) --

          • (string) --

      • CloudMaskingConfig (dict) --

        An object containing information about the job configuration for cloud masking.

      • CloudRemovalConfig (dict) --

        An object containing information about the job configuration for cloud removal.

        • AlgorithmName (string) --

          The name of the algorithm used for cloud removal.

        • InterpolationValue (string) --

          The interpolation value you provide for cloud removal.

        • TargetBands (list) --

          • (string) --

      • GeoMosaicConfig (dict) --

        An object containing information about the job configuration for geomosaic.

        • AlgorithmName (string) --

          The name of the algorithm being used for geomosaic.

        • TargetBands (list) --

          The target bands for geomosaic.

          • (string) --

      • LandCoverSegmentationConfig (dict) --

        An object containing information about the job configuration for land cover segmentation.

      • ResamplingConfig (dict) --

        An object containing information about the job configuration for resampling.

        • AlgorithmName (string) --

          The name of the algorithm used for resampling.

        • OutputResolution (dict) --

          • UserDefined (dict) --

            • Unit (string) --

            • Value (float) --

        • TargetBands (list) --

          • (string) --

      • StackConfig (dict) --

        • OutputResolution (dict) --

          • Predefined (string) --

          • UserDefined (dict) --

            • Unit (string) --

            • Value (float) --

        • TargetBands (list) --

          • (string) --

      • TemporalStatisticsConfig (dict) --

        An object containing information about the job configuration for temporal statistics.

        • GroupBy (string) --

        • Statistics (list) --

          • (string) --

        • TargetBands (list) --

          • (string) --

      • ZonalStatisticsConfig (dict) --

        An object containing information about the job configuration for zonal statistics.

        • Statistics (list) --

          • (string) --

        • TargetBands (list) --

          • (string) --

        • ZoneS3Path (string) --

    • KmsKeyId (string) --

      The Amazon Key Management Service (KMS) key ID for server-side encryption.

    • Name (string) --

      The name of the Earth Observation job.

    • Status (string) --

      The status of the Earth Observation job.

    • Tags (dict) --

      Each tag consists of a key and a value.

      • (string) --

        • (string) --

StopVectorEnrichmentJob (new) Link ¶

Stops the Vector Enrichment job for a given job ARN.

See also: AWS API Documentation

Request Syntax

client.stop_vector_enrichment_job(
    Arn='string'
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the Vector Enrichment job.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

ListTagsForResource (new) Link ¶

Lists the tags attached to the resource.

See also: AWS API Documentation

Request Syntax

client.list_tags_for_resource(
    ResourceArn='string'
)
type ResourceArn:

string

param ResourceArn:

[REQUIRED]

The Amazon Resource Name (ARN) of the resource you want to tag.

rtype:

dict

returns:

Response Syntax

{
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • Tags (dict) --

      Each tag consists of a key and a value.

      • (string) --

        • (string) --

GetEarthObservationJob (new) Link ¶

Get the details for a previously initiated Earth Observation job.

See also: AWS API Documentation

Request Syntax

client.get_earth_observation_job(
    Arn='string'
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the Earth Observation job.

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'CreationTime': datetime(2015, 1, 1),
    'DurationInSeconds': 123,
    'ErrorDetails': {
        'Message': 'string',
        'Type': 'CLIENT_ERROR'|'SERVER_ERROR'
    },
    'ExecutionRoleArn': 'string',
    'ExportErrorDetails': {
        'ExportResults': {
            'Message': 'string',
            'Type': 'CLIENT_ERROR'|'SERVER_ERROR'
        },
        'ExportSourceImages': {
            'Message': 'string',
            'Type': 'CLIENT_ERROR'|'SERVER_ERROR'
        }
    },
    'ExportStatus': 'IN_PROGRESS'|'SUCCEEDED'|'FAILED',
    'InputConfig': {
        'DataSourceConfig': {
            'S3Data': {
                'KmsKeyId': 'string',
                'MetadataProvider': 'PLANET_ORDER',
                'S3Uri': 'string'
            }
        },
        'PreviousEarthObservationJobArn': 'string',
        'RasterDataCollectionQuery': {
            'AreaOfInterest': {
                'AreaOfInterestGeometry': {
                    'MultiPolygonGeometry': {
                        'Coordinates': [
                            [
                                [
                                    [
                                        123.0,
                                    ],
                                ],
                            ],
                        ]
                    },
                    'PolygonGeometry': {
                        'Coordinates': [
                            [
                                [
                                    123.0,
                                ],
                            ],
                        ]
                    }
                }
            },
            'PropertyFilters': {
                'LogicalOperator': 'AND',
                'Properties': [
                    {
                        'Property': {
                            'EoCloudCover': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'LandsatCloudCoverLand': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'Platform': {
                                'ComparisonOperator': 'EQUALS'|'NOT_EQUALS'|'STARTS_WITH',
                                'Value': 'string'
                            },
                            'ViewOffNadir': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'ViewSunAzimuth': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            },
                            'ViewSunElevation': {
                                'LowerBound': ...,
                                'UpperBound': ...
                            }
                        }
                    },
                ]
            },
            'RasterDataCollectionArn': 'string',
            'RasterDataCollectionName': 'string',
            'TimeRangeFilter': {
                'EndTime': datetime(2015, 1, 1),
                'StartTime': datetime(2015, 1, 1)
            }
        }
    },
    'JobConfig': {
        'BandMathConfig': {
            'CustomIndices': {
                'Operations': [
                    {
                        'Equation': 'string',
                        'Name': 'string',
                        'OutputType': 'INT32'|'FLOAT32'|'INT16'|'FLOAT64'|'UINT16'
                    },
                ]
            },
            'PredefinedIndices': [
                'string',
            ]
        },
        'CloudMaskingConfig': {},
        'CloudRemovalConfig': {
            'AlgorithmName': 'INTERPOLATION',
            'InterpolationValue': 'string',
            'TargetBands': [
                'string',
            ]
        },
        'GeoMosaicConfig': {
            'AlgorithmName': 'NEAR'|'BILINEAR'|'CUBIC'|'CUBICSPLINE'|'LANCZOS'|'AVERAGE'|'RMS'|'MODE'|'MAX'|'MIN'|'MED'|'Q1'|'Q3'|'SUM',
            'TargetBands': [
                'string',
            ]
        },
        'LandCoverSegmentationConfig': {},
        'ResamplingConfig': {
            'AlgorithmName': 'NEAR'|'BILINEAR'|'CUBIC'|'CUBICSPLINE'|'LANCZOS'|'AVERAGE'|'RMS'|'MODE'|'MAX'|'MIN'|'MED'|'Q1'|'Q3'|'SUM',
            'OutputResolution': {
                'UserDefined': {
                    'Unit': 'METERS',
                    'Value': ...
                }
            },
            'TargetBands': [
                'string',
            ]
        },
        'StackConfig': {
            'OutputResolution': {
                'Predefined': 'HIGHEST'|'LOWEST'|'AVERAGE',
                'UserDefined': {
                    'Unit': 'METERS',
                    'Value': ...
                }
            },
            'TargetBands': [
                'string',
            ]
        },
        'TemporalStatisticsConfig': {
            'GroupBy': 'ALL'|'YEARLY',
            'Statistics': [
                'MEAN'|'MEDIAN'|'STANDARD_DEVIATION',
            ],
            'TargetBands': [
                'string',
            ]
        },
        'ZonalStatisticsConfig': {
            'Statistics': [
                'MEAN'|'MEDIAN'|'STANDARD_DEVIATION'|'MAX'|'MIN'|'SUM',
            ],
            'TargetBands': [
                'string',
            ],
            'ZoneS3Path': 'string'
        }
    },
    'KmsKeyId': 'string',
    'Name': 'string',
    'OutputBands': [
        {
            'BandName': 'string',
            'OutputDataType': 'INT32'|'FLOAT32'|'INT16'|'FLOAT64'|'UINT16'
        },
    ],
    'Status': 'INITIALIZING'|'IN_PROGRESS'|'STOPPING'|'COMPLETED'|'STOPPED'|'FAILED'|'DELETING'|'DELETED',
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • Arn (string) --

      The Amazon Resource Name (ARN) of the Earth Observation job.

    • CreationTime (datetime) --

      The creation time of the initiated Earth Observation job.

    • DurationInSeconds (integer) --

      The duration of Earth Observation job, in seconds.

    • ErrorDetails (dict) --

      Details about the errors generated during the Earth Observation job.

      • Message (string) --

      • Type (string) --

    • ExecutionRoleArn (string) --

      The Amazon Resource Name (ARN) of the IAM role that you specified for the job.

    • ExportErrorDetails (dict) --

      Details about the errors generated during ExportEarthObservationJob.

      • ExportResults (dict) --

        • Message (string) --

        • Type (string) --

      • ExportSourceImages (dict) --

        • Message (string) --

        • Type (string) --

    • ExportStatus (string) --

      The status of the Earth Observation job.

    • InputConfig (dict) --

      Input data for the Earth Observation job.

      • DataSourceConfig (dict) --

        The location of the input data.

        • S3Data (dict) --

          • KmsKeyId (string) --

            The Amazon Key Management Service (KMS) key ID for server-side encryption.

          • MetadataProvider (string) --

          • S3Uri (string) --

            The URL to the Amazon S3 input.

      • PreviousEarthObservationJobArn (string) --

        The Amazon Resource Name (ARN) of the previous Earth Observation job.

      • RasterDataCollectionQuery (dict) --

        • AreaOfInterest (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys will be set: AreaOfInterestGeometry. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          • AreaOfInterestGeometry (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys will be set: MultiPolygonGeometry, PolygonGeometry. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

            'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
            • MultiPolygonGeometry (dict) --

              • Coordinates (list) --

                The coordinates of the multipolygon geometry.

                • (list) --

                  • (list) --

                    • (list) --

                      • (float) --

            • PolygonGeometry (dict) --

              • Coordinates (list) --

                • (list) --

                  • (list) --

                    • (float) --

        • PropertyFilters (dict) --

          • LogicalOperator (string) --

          • Properties (list) --

            • (dict) --

              • Property (dict) -- .. note:: This is a Tagged Union structure. Only one of the following top level keys will be set: EoCloudCover, LandsatCloudCoverLand, Platform, ViewOffNadir, ViewSunAzimuth, ViewSunElevation. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

                'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
                • EoCloudCover (dict) --

                  • LowerBound (float) --

                  • UpperBound (float) --

                • LandsatCloudCoverLand (dict) --

                  • LowerBound (float) --

                  • UpperBound (float) --

                • Platform (dict) --

                  • ComparisonOperator (string) --

                  • Value (string) --

                    The value of the platform.

                • ViewOffNadir (dict) --

                  • LowerBound (float) --

                  • UpperBound (float) --

                • ViewSunAzimuth (dict) --

                  • LowerBound (float) --

                  • UpperBound (float) --

                • ViewSunElevation (dict) --

                  • LowerBound (float) --

                    The lower bound to view the sun elevation.

                  • UpperBound (float) --

                    The upper bound to view the sun elevation.

        • RasterDataCollectionArn (string) --

        • RasterDataCollectionName (string) --

          The name of the raster data collection.

        • TimeRangeFilter (dict) --

          • EndTime (datetime) --

            The end time for the time-range filter.

          • StartTime (datetime) --

            The start time for the time-range filter.

    • JobConfig (dict) --

      An object containing information about the job configuration.

      • BandMathConfig (dict) --

        • CustomIndices (dict) --

          • Operations (list) --

            • (dict) --

              • Equation (string) --

              • Name (string) --

                The name of the operation.

              • OutputType (string) --

                The type of the operation.

        • PredefinedIndices (list) --

          • (string) --

      • CloudMaskingConfig (dict) --

        An object containing information about the job configuration for cloud masking.

      • CloudRemovalConfig (dict) --

        An object containing information about the job configuration for cloud removal.

        • AlgorithmName (string) --

          The name of the algorithm used for cloud removal.

        • InterpolationValue (string) --

          The interpolation value you provide for cloud removal.

        • TargetBands (list) --

          • (string) --

      • GeoMosaicConfig (dict) --

        An object containing information about the job configuration for geomosaic.

        • AlgorithmName (string) --

          The name of the algorithm being used for geomosaic.

        • TargetBands (list) --

          The target bands for geomosaic.

          • (string) --

      • LandCoverSegmentationConfig (dict) --

        An object containing information about the job configuration for land cover segmentation.

      • ResamplingConfig (dict) --

        An object containing information about the job configuration for resampling.

        • AlgorithmName (string) --

          The name of the algorithm used for resampling.

        • OutputResolution (dict) --

          • UserDefined (dict) --

            • Unit (string) --

            • Value (float) --

        • TargetBands (list) --

          • (string) --

      • StackConfig (dict) --

        • OutputResolution (dict) --

          • Predefined (string) --

          • UserDefined (dict) --

            • Unit (string) --

            • Value (float) --

        • TargetBands (list) --

          • (string) --

      • TemporalStatisticsConfig (dict) --

        An object containing information about the job configuration for temporal statistics.

        • GroupBy (string) --

        • Statistics (list) --

          • (string) --

        • TargetBands (list) --

          • (string) --

      • ZonalStatisticsConfig (dict) --

        An object containing information about the job configuration for zonal statistics.

        • Statistics (list) --

          • (string) --

        • TargetBands (list) --

          • (string) --

        • ZoneS3Path (string) --

    • KmsKeyId (string) --

      The Amazon Key Management Service (KMS) key ID for server-side encryption.

    • Name (string) --

      The name of the Earth Observation job.

    • OutputBands (list) --

      • (dict) --

        A single EarthObservationJob output band.

        • BandName (string) --

          The name of the band.

        • OutputDataType (string) --

          The datatype of the output band.

    • Status (string) --

      The status of a previously initiated Earth Observation job.

    • Tags (dict) --

      Each tag consists of a key and a value.

      • (string) --

        • (string) --

DeleteEarthObservationJob (new) Link ¶

Use this operation to delete an Earth Observation job.

See also: AWS API Documentation

Request Syntax

client.delete_earth_observation_job(
    Arn='string'
)
type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the Earth Observation job being deleted.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

UntagResource (new) Link ¶

The resource you want to untag.

See also: AWS API Documentation

Request Syntax

client.untag_resource(
    ResourceArn='string',
    TagKeys=[
        'string',
    ]
)
type ResourceArn:

string

param ResourceArn:

[REQUIRED]

The Amazon Resource Name (ARN) of the resource you want to untag.

type TagKeys:

list

param TagKeys:

[REQUIRED]

Keys of the tags you want to remove.

  • (string) --

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --