View a markdown version of this page

Amazon SageMaker 지리 공간 맵 SDK - Amazon SageMaker AI

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon SageMaker 지리 공간 맵 SDK

참고

Amazon SageMaker 지리 공간 기능은 더 이상 신규 고객에게 공개되지 않습니다. ExportEarthObservationJobExportVectorEnrichmentJob API 작업을 사용하여 이전에 저장된 작업을 Amazon S3로 오프보드합니다.

Amazon SageMaker 지리 공간 기능을 사용하여 SageMaker 지리 공간 UI와 지리 공간 이미지가 포함된 SageMaker 노트북에서 맵을 시각화할 수 있습니다. 이러한 시각화는 Foursquare Studio라는 맵 시각화 라이브러리에서 지원됩니다.

SageMaker 지리 공간 맵 SDK에서 제공하는 API를 사용하여 EOJ용 입력, 출력, AoI를 비롯한 지리 공간 데이터를 시각화할 수 있습니다.

add_dataset API

래스터 또는 벡터 데이터세트 객체를 맵에 추가합니다.

요청 구문

Request = add_dataset( self, dataset: Union[Dataset, Dict, None] = None, *, auto_create_layers: bool = True, center_map: bool = True, **kwargs: Any, ) -> Optional[Dataset]

요청 파라미터

요청은 다음 파라미터를 수용합니다.

위치 인수

인수

유형

설명

dataset

Union[Dataset, Dict, None]

CSV, JSON, GeoJSON 형식(로컬 데이터세트의 경우) 또는 UUID 문자열로 데이터세트를 만드는 데 사용되는 데이터입니다.

키워드 인수

인수

유형

설명

auto_create_layers

부울

데이터세트를 추가할 때 새 계층 생성을 시도할지 여부입니다. 기본값은 False입니다.

center_map

부울

생성된 데이터세트에 맵을 중앙에 배치할지 여부입니다. 기본값은 True입니다.

id

문자열

데이터세트의 고유 식별자입니다. 제공하지 않은 경우 임의의 ID가 생성됩니다.

label

문자열

표시되는 데이터 세트 레이블입니다.

color

Tuple[float, float, float]

데이터 세트의 색상 레이블입니다.

metadata

사전

타일 세트 메타데이터를 포함하는 개체입니다(타일 데이터세트용).

응답

이 API는 맵에 추가된 데이터세트 객체를 반환합니다.

update_dataset API

기존 데이터세트의 설정을 업데이트합니다.

요청 구문

Request = update_dataset( self, dataset_id: str, values: Union[_DatasetUpdateProps, dict, None] = None, **kwargs: Any, ) -> Dataset

요청 파라미터

요청은 다음 파라미터를 수용합니다.

위치 인수

인수

유형

설명

dataset_id

문자열

업데이트할 데이터세트의 식별자입니다.

values

Union[_DatasetUpdateProps, dict, None]

업데이트할 값입니다.

키워드 인수

인수

유형

설명

label

문자열

표시되는 데이터 세트 레이블입니다.

color

RGBColor

데이터 세트의 색상 레이블입니다.

응답

이 API는 대화형 맵의 경우 업데이트된 데이터세트 객체를 반환하고, 비대화형 HTML 환경의 경우 None을 반환합니다.

add_layer API

맵에 새 계층을 추가합니다. 이 기능을 사용하려면 하나 이상의 유효한 계층 구성이 필요합니다.

요청 구문

Request = add_layer( self, layer: Union[LayerCreationProps, dict, None] = None, **kwargs: Any ) -> Layer

요청 파라미터

요청은 다음 파라미터를 수용합니다.

인수

인수

유형

설명

layer

Union[LayerCreationProps, dict, None]

계층을 생성하는 데 사용되는 속성 세트입니다.

응답

맵에 추가된 계층 객체입니다.

update_layer API

기존 계층을 지정된 값으로 업데이트합니다.

요청 구문

Request = update_layer( self, layer_id: str, values: Union[LayerUpdateProps, dict, None], **kwargs: Any ) -> Layer

요청 파라미터

요청은 다음 파라미터를 수용합니다.

인수

위치 인수

유형

설명

layer_id

문자열

업데이트할 계층의 ID입니다.

values

Union[LayerUpdateProps, dict, None]

업데이트할 값입니다.

키워드 인수

인수

유형

설명

type

LayerType

계층의 유형입니다.

data_id

문자열

이 계층이 시각화하는 데이터세트의 고유 식별자입니다.

fields

Dict [string, Optional[string]]

계층에서 시각화에 필요한 필드를 적절한 데이터세트 필드에 매핑하는 사전입니다.

label

문자열

이 계층의 정식 레이블입니다.

is_visible

부울

계층이 표시되는지 여부입니다.

config

LayerConfig

해당 유형에 맞는 계층 구성입니다.

응답

업데이트된 계층 객체를 반환합니다.

visualize_eoj_aoi API

지정된 작업 ARN의 AoI를 시각화합니다.

요청 파라미터

요청은 다음 파라미터를 수용합니다.

인수

인수

유형

설명

Arn

문자열

작업의 ARN입니다.

config

사전

config = { label: <string> custom label of the added AoI layer, default AoI }

계층 속성을 전달하는 옵션입니다.

응답

추가된 입력 계층 개체의 참조입니다.

visualize_eoj_input API

지정된 EOJ ARN의 입력을 시각화합니다.

요청 파라미터

요청은 다음 파라미터를 수용합니다.

인수

인수

유형

설명

Arn

문자열

작업의 ARN입니다.

time_range_filter

사전

time_range_filter = {

start_date: <string> date in ISO format

end_date: <string> date in ISO format

}

시작 및 종료 시간을 제공하는 옵션입니다. 래스터 데이터 컬렉션 검색 시작 및 종료 날짜가 기본값입니다.

config

사전

config = { label: <string> custom label of the added output layer, default Input }

계층 속성을 전달하는 옵션입니다.

응답

추가된 입력 계층 개체의 참조입니다.

visualize_eoj_output API

지정된 EOJ ARN의 출력을 시각화합니다.

요청 파라미터

요청은 다음 파라미터를 수용합니다.

인수

인수

유형

설명

Arn

문자열

작업의 ARN입니다.

time_range_filter

사전

time_range_filter = {

start_date: <string> date in ISO format

end_date: <string> date in ISO format

}

시작 및 종료 시간을 제공하는 옵션입니다. 래스터 데이터 컬렉션 검색 시작 및 종료 날짜가 기본값입니다.

config

사전

config = {

label: <string> custom label of the added output layer, default Output

preset: <string> singleBand or trueColor,

band_name: <string>, only required for 'singleBand' preset. EOJ에 허용되는 밴드

}

계층 속성을 전달하는 옵션입니다.

응답

추가된 출력 계층 객체의 참조입니다.

지리 공간 데이터를 시각화하는 방법에 대해 자세히 알아보려면 Amazon SageMaker를 사용한 지리 공간 시각화를 참조하세요.