search_raster_data_collection¶

search_raster_data_collection(**kwargs)¶

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

response = 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)
        }
    }
)

Parameters

Arn (string) --
[REQUIRED]

The Amazon Resource Name (ARN) of the raster data collection.
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.
RasterDataCollectionQuery (dict) --
[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.

Return type

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.

Exceptions

SageMakergeospatialcapabilities.Client.exceptions.AccessDeniedException
SageMakergeospatialcapabilities.Client.exceptions.ValidationException
SageMakergeospatialcapabilities.Client.exceptions.ThrottlingException
SageMakergeospatialcapabilities.Client.exceptions.InternalServerException
SageMakergeospatialcapabilities.Client.exceptions.ResourceNotFoundException

Table Of Contents

search_raster_data_collection¶