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

# Amazon SageMaker 지리 공간 맵 SDK
<a name="geospatial-notebook-sdk"></a>

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

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

**Topics**
+ [add\$1dataset API](#geo-add-dataset)
+ [update\$1dataset API](#geo-update-dataset)
+ [add\$1layer API](#geo-add-layer)
+ [update\$1layer API](#geo-update-layer)
+ [visualize\$1eoj\$1aoi API](#geo-visualize-eoj-aoi)
+ [visualize\$1eoj\$1input API](#geo-visualize-eoj-input)
+ [visualize\$1eoj\$1output API](#geo-visualize-eoj-output)

## add\$1dataset API
<a name="geo-add-dataset"></a>

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

**요청 구문**

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

**요청 파라미터**

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

위치 인수


| 인수 |  Type  |  설명  | 
| --- | --- | --- | 
| `dataset` | Union[Dataset, Dict, None] | CSV, JSON, GeoJSON 형식(로컬 데이터세트의 경우) 또는 UUID 문자열로 데이터세트를 만드는 데 사용되는 데이터입니다. | 

키워드 인수


| 인수 |  Type  |  설명  | 
| --- | --- | --- | 
| `auto_create_layers` | 부울 | 데이터세트를 추가할 때 새 계층 생성을 시도할지 여부입니다. 기본값은 `False`입니다. | 
| `center_map` | 부울 | 생성된 데이터세트에 맵을 중앙에 배치할지 여부입니다. 기본값은 `True`입니다. | 
| `id` | 문자열 | 데이터세트의 고유 식별자입니다. 제공하지 않은 경우 임의의 ID가 생성됩니다. | 
| `label` | 문자열 | 표시되는 데이터 세트 레이블입니다. | 
| `color` | Tuple[float, float, float] | 데이터 세트의 색상 레이블입니다. | 
| `metadata` | 사전 | 타일 세트 메타데이터를 포함하는 개체입니다(타일 데이터세트용). | 

**응답**

이 API는 맵에 [추가된 데이터세트](https://location.foursquare.com/developer/docs/studio-map-sdk-types#dataset) 객체를 반환합니다.

## update\$1dataset API
<a name="geo-update-dataset"></a>

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

**요청 구문**

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

**요청 파라미터**

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

위치 인수


| 인수 |  Type  |  설명  | 
| --- | --- | --- | 
| `dataset_id` | 문자열 | 업데이트할 데이터세트의 식별자입니다. | 
| `values` | Union[[\$1DatasetUpdateProps](https://location.foursquare.com/developer/docs/studio-map-sdk-types#datasetupdateprops), dict, None] | 업데이트할 값입니다. | 

키워드 인수


| 인수 |  Type  |  설명  | 
| --- | --- | --- | 
| `label` | 문자열 | 표시되는 데이터 세트 레이블입니다. | 
| `color` | [RGBColor](https://location.foursquare.com/developer/docs/studio-map-sdk-types#rgbcolor) | 데이터 세트의 색상 레이블입니다. | 

**응답**

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

## add\$1layer API
<a name="geo-add-layer"></a>

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

**요청 구문**

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

**요청 파라미터**

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

인수


| 인수 |  Type  |  설명  | 
| --- | --- | --- | 
| `layer` | Union[[LayerCreationProps](https://location.foursquare.com/developer/docs/studio-map-sdk-types#layercreationprops), dict, None] | 계층을 생성하는 데 사용되는 속성 세트입니다. | 

**응답**

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

## update\$1layer API
<a name="geo-update-layer"></a>

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

**요청 구문**

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

**요청 파라미터**

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

인수


| 위치 인수 |  Type  |  설명  | 
| --- | --- | --- | 
| `layer_id` | 문자열 | 업데이트할 계층의 ID입니다. | 
| `values` | Union[[LayerUpdateProps](https://location.foursquare.com/developer/docs/studio-map-sdk-types#layerupdateprops), dict, None] | 업데이트할 값입니다. | 

키워드 인수


| 인수 |  Type  |  설명  | 
| --- | --- | --- | 
| `type` | [LayerType](https://location.foursquare.com/developer/docs/studio-map-sdk-types#layertype) | 계층의 유형입니다. | 
| `data_id` | 문자열 | 이 계층이 시각화하는 데이터세트의 고유 식별자입니다. | 
| `fields` | Dict [string, Optional[string]] | 계층에서 시각화에 필요한 필드를 적절한 데이터세트 필드에 매핑하는 사전입니다. | 
| `label` | 문자열 | 이 계층의 정식 레이블입니다. | 
| `is_visible` | 부울 | 계층이 표시되는지 여부입니다. | 
| `config` | [LayerConfig](https://location.foursquare.com/developer/docs/studio-map-sdk-types#layerconfig) | 해당 유형에 맞는 계층 구성입니다. | 

**응답**

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

## visualize\$1eoj\$1aoi API
<a name="geo-visualize-eoj-aoi"></a>

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

**요청 파라미터**

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

인수


| 인수 |  Type  |  설명  | 
| --- | --- | --- | 
|  `Arn`  |  문자열  |  작업의 ARN입니다.  | 
|  `config`  |  사전 config = \$1 label: <string> custom label of the added AoI layer, default AoI \$1  |  계층 속성을 전달하는 옵션입니다.  | 

**응답**

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

## visualize\$1eoj\$1input API
<a name="geo-visualize-eoj-input"></a>

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

**요청 파라미터**

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

인수


| 인수 |  Type  |  설명  | 
| --- | --- | --- | 
| `Arn` | 문자열 | 작업의 ARN입니다. | 
| `time_range_filter` |  사전 time\$1range\$1filter = \$1 start\$1date: <string> date in ISO format end\$1date: <string> date in ISO format \$1  | 시작 및 종료 시간을 제공하는 옵션입니다. 래스터 데이터 컬렉션 검색 시작 및 종료 날짜가 기본값입니다. | 
| `config` |  사전 config = \$1 label: <string> custom label of the added output layer, default Input \$1  | 계층 속성을 전달하는 옵션입니다. | 

**응답**

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

## visualize\$1eoj\$1output API
<a name="geo-visualize-eoj-output"></a>

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

**요청 파라미터**

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

인수


| 인수 |  Type  |  설명  | 
| --- | --- | --- | 
|  `Arn`  |  문자열  |  작업의 ARN입니다.  | 
|  `time_range_filter`  |  사전 time\$1range\$1filter = \$1 start\$1date: <string> date in ISO format end\$1date: <string> date in ISO format \$1  | 시작 및 종료 시간을 제공하는 옵션입니다. 래스터 데이터 컬렉션 검색 시작 및 종료 날짜가 기본값입니다. | 
| `config` |  사전 config = \$1 label: <string> custom label of the added output layer, default Output preset: <string> singleBand or trueColor, band\$1name: <string>, only required for 'singleBand' preset. EOJ에 허용되는 밴드 \$1  | 계층 속성을 전달하는 옵션입니다. | 

**응답**

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

지리 공간 데이터를 시각화하는 방법에 대해 자세히 알아보려면 Amazon [SageMaker를 사용한 지리 공간 시각화](https://docs.aws.amazon.com/sagemaker/latest/dg/geospatial-visualize.html)를 참조하세요.