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.

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) --

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) --

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

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) --

    • AreaOfInterestGeometry (dict) --

      • 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]

          • 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.

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) --

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.

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.

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) --

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) --

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.

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.

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) --

        • 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]

            • 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) --

          • AreaOfInterestGeometry (dict) --

            • 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) --

                • 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) --

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.

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]

    • 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) --

        • 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.

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.

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) --

          • AreaOfInterestGeometry (dict) --

            • 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) --

                • 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) --

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) --

        • 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.

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) --