기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 정적 맵 **참고** 정적 맵은 표준 및 위성 스타일만 지원합니다. 자세한 내용은 [AWS 맵 스타일 및 기능](map-styles.md) 단원을 참조하십시오. 정적 맵은 애플리케이션에 필요한 대로 마커(또는 핀), 경로 및 다각형 영역을 오버레이할 수 있는 옵션을 통해 미리 렌더링된 지리적 데이터 표현을 제공합니다. 정적 맵을 사용하면 사용자 지정 가능한 파라미터 및 데이터 입력을 기반으로 정적(비대화형) 맵 이미지를 생성할 수 있습니다. 오버레이, 셰이프를 사용자 지정하거나 사용자 지정 스타일을 적용하여 정적 맵을 사용하면 특정 요구 사항을 충족하는 맵 시각화를 생성하여 최종 사용자 경험을 개선하고 지리적 정보를 효과적으로 전달할 수 있습니다. 서버는 요청된 맵 이미지를 사용자 지정하고 클라이언트에 JPEG 파일로 전송합니다. 프로그래밍 방식으로 특정 요구 사항에 맞는 맵 이미지를 요청하고 생성할 수 있습니다. *GetStaticMap API*는 중앙 좌표, 경계 상자 또는 오버레이와 같은 지정된 파라미터를 기반으로 맵의 정적 이미지를 생성합니다. API를 사용하면 맵 기능과 스타일을 사용자 지정할 수 있으므로 대화형 맵 기능 없이 웹 또는 모바일 애플리케이션에서 사용할 수 있습니다. 자세한 내용은 *Amazon Location Service API 참조*의 [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html) 섹션을 참조하세요. 이 API에 대한 요청, 응답, cURL 및 CLI 명령의 예는 [정적 맵](https://docs.aws.amazon.com/location/latest/developerguide/static-maps-how-to.html)을 사용하는 방법을 참조하세요. ## 일반 사용 사례 + **웹 또는 모바일 애플리케이션의 임베디드 맵:** 정적 맵 이미지를 웹 사이트 또는 모바일 애플리케이션에 효율적으로 내장하여 비대화형 맵으로 위치, 경로 또는 관심 지점을 시각화하여 로드 시간과 데이터 사용량을 줄일 수 있습니다. 예를 들어, POI에 대한 검색 결과와 함께 지도 이미지를 보여주는 검색 엔진(예: Yahoo)이 있습니다. + **이메일의 위치 세부 정보:** 정적 맵 이미지를 사용하여 최종 사용자가 이메일의 컨텍스트를 이해하는 데 도움이 되도록 이메일을 통해 위치 정보를 공유할 수 있습니다. 예를 들어 음식 배달 또는 차량 공유 앱은 정적 맵 이미지를 사용하여 운송 후 이메일 또는 청구서와 요약이 포함된 배달 이메일에 픽업/반납 위치, 경로 또는 주변 영역을 표시합니다. + **마케팅 자료 및 인쇄된 문서:** 사용자 지정된 정적 맵 이미지를 브로슈어, 전단지 또는 기타 인쇄된 자료에 통합하여 콘텐츠와 관련된 지리적 정보를 시각적으로 매력적인 방식으로 표현할 수 있습니다. ## 요청 이해 요청에는 특히 맵의 가시 영역 및 오버레이를 정의하기 위한 `BoundedPositions`, `BoundingBox`, `Center`와 같은 선택적 URI 파라미터가 포함됩니다. 파라미터 `Height` 및 `Width`는 이미지 크기를 정의하는 데 필요합니다. 자세한 내용은 [정적 맵 사용자 지정](customizing-static-maps.md) 및 [정적 맵의 오버레이](overlaying-static-map.md) 섹션을 참조하세요. + `BoundedPositions`: 이미지에 포함할 좌표입니다. + `BoundingBox`: 맵의 남서부 및 북동부 엣지를 정의하는 좌표입니다. + `Height`: 이미지의 높이를 지정합니다. + `Width`: 이미지의 너비를 지정합니다. + `GeoJsonOverlay`: 오버레이를 추가하는 데 유효한 GeoJSON 객체입니다. ## 응답 이해 응답에는 `CacheControl`, `ContentType`, `ETag`와 같은 헤더가 포함되어 있으며 정적 맵을 JPEG 또는 PNG 형식의 이진 BLOB으로 반환합니다. 헤더는 정적 이미지에 대한 캐시 제어, 콘텐츠 유형 및 버전과 같은 메타데이터를 제공합니다. + `CacheControl`: 맵 이미지에 대한 캐싱 구성을 지정합니다. + `ContentType`: 맵 이미지의 형식을 나타냅니다(JPEG 또는 PNG). + `ETag`: 정적 맵 이미지 버전의 식별자입니다. + `Blob`: 맵 이미지를 JPEG 또는 PNG 형식으로 나타냅니다. # 정적 맵 사용자 지정 **참고** 정적 맵은 위성 스타일만 지원합니다. 자세한 내용은 [AWS 맵 스타일 및 기능](map-styles.md) 단원을 참조하십시오. 이 섹션에서는 Amazon Location Service를 사용하여 생성된 정적 맵을 사용자 지정하는 방법에 대한 개요를 제공합니다. 맵의 위치, 크기, 언어, 규모, 오버레이 및 속성 조정과 같은 다양한 기능을 다루므로 특정 요구 사항에 맞게 맵을 조정할 수 있습니다. 자세한 내용은 *Amazon Location Service API 참조*의 [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html) 섹션을 참조하세요. ## 위치 위치를 사용하면 맵의 중심과 경계를 정의할 수 있습니다. 가운데 좌표, 경계 상자를 설정하거나 확대/축소 수준을 사용하여 표시할 영역을 결정하여 맵의 초점을 제어할 수 있습니다. 작동 방식에 대해 알아보려면 [특정 위치의 정적 맵을 가져오는 방법](get-static-map-specific-position.md) 섹션을 참조하세요. + `Center`: 경도 및 위도 좌표를 사용하여 맵의 중심점을 정의합니다. + `Radius`: 정적 맵에 표시될 반경(중심으로부터의 거리)을 지정합니다. + `Bounding Box`: 왼쪽 상단 및 오른쪽 하단 모서리의 좌표를 제공하여 맵의 직사각형 영역을 정의합니다. + `Zoom`: 맵의 확대/축소 수준을 제어합니다. 확대/축소 수준이 높을수록 더 작은 영역에서 더 많은 세부 정보가 표시되고, 확대/축소 수준이 낮을수록 더 큰 영역에서 더 적은 세부 정보가 표시됩니다. ## 차원 및 품질 차원(높이 및 너비)을 정의하고 마커 및 기타 요소를 더 잘 표현하기 위해 패딩을 추가하여 정적 맵의 크기와 시각적 품질을 사용자 지정할 수 있습니다. 작동 방식에 대해 알아보려면 [특정 차원의 정적 맵을 가져오는 방법](get-static-map-specific-dimension.md) 섹션을 참조하세요. + `Height and Width`: 높이와 너비를 픽셀 단위로 정의하여 정적 맵 이미지의 크기를 지정합니다. + `Padding`: 맵 가장자리 주위에 공간을 더 추가하여 마커, 선 또는 셰이프를 배치할 때 더욱 잘 시각화할 수 있습니다. ## 규모 조정 규모 조정은 맵의 크기를 제어하고 거리를 측정할 단위(킬로미터, 마일)를 정의합니다. 이는 맵의 크기 및 거리 관계를 정확하게 나타내는 데 유용합니다. 작동 방식에 대해 알아보려면 [정적 맵에 대한 스케일을 추가하는 방법](add-scale-static-map.md) 섹션을 참조하세요. + `Scale Unit`: 맵의 규모 조정 막대에 대한 단위(예: 킬로미터 또는 마일)를 정의하여 사용자가 맵에서 거리를 정확하게 측정할 수 있도록 합니다. ## 오버레이 마커, 경로를 표시하는 선, 영역을 표시하는 다각형 등을 추가할 수 있습니다. 작동 방식에 대해 알아보려면 [정적 맵에 마커를 추가하는 방법](add-marker-static-map.md), [정적 맵에 선을 추가하는 방법](how-to-add-line-static.md) 또는 [정적 맵에 경로를 추가하는 방법](how-to-add-route.md) 섹션을 참조하세요. # 정적 맵의 오버레이 이 섹션에서는 Amazon Location Service를 사용하여 정적 맵에 추가 정보를 오버레이하는 방법을 설명합니다. 점, 선, 다각형과 같은 다양한 지리적 특성을 추가하여 정적 맵을 사용자 지정하여 맵의 시각적 표현을 개선할 수 있습니다. Amazon Location Service는 GeoJSON 및 소형 오버레이 형식을 비롯한 여러 형식을 지원하여 유연하고 효율적인 오버레이 추가 방법을 제공합니다. 자세한 내용은 *Amazon Location Service API 참조*의 [GetStaticMap](https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStaticMap.html) 섹션을 참조하세요. ## GeoJSON 사용 GeoJSON은 정적 맵에 사용자 지정 데이터를 오버레이할 수 있는 다목적 형식입니다. 점, 선, 다각형과 같은 지리적 특성을 정의하면 맵의 시각적 표현을 개선하여 사용자에게 중요한 컨텍스트를 제공할 수 있습니다. GeoJSON은 널리 지원되며 맵 오버레이를 스타일 지정하고 사용자 지정할 때 유연성을 제공하므로 리전 표시, 경로 플로팅 또는 공간 관계 표시에 이상적인 형식입니다. Amazon Location Service를 사용하면 GeoJSON을 활용하여 정적 맵에 직접 동적 위치 기반 기능을 추가할 수 있습니다. 이를 통해 특정 비즈니스 요구 사항에 맞게 조정할 수 있는 고도로 사용자 지정 가능한 오버레이를 생성할 수 있습니다. GeoJSON은 `Point`, `LineString`, `Polygon` 및 `MultiPolygon`을 비롯한 여러 지오메트리 유형을 지원하므로 마커 및 경로부터 복잡한 영역 표현에 이르기까지 다양한 기능을 표시할 수 있습니다. ## 색상 GeoJSON 기능을 스타일 지정할 때 색상을 유연하게 정의할 수 있습니다. 16진수 값(빨간색의 경우 \$1ff0000) 또는 알파 투명도(반투명 빨간색의 경우 \$1ff000080)와 같은 다양한 형식을 사용하여 색상을 지정할 수 있습니다. 이렇게 하면 오버레이가 맵 스타일과 시각적으로 일치할 수 있습니다. 색상을 지정하지 않으면 선택한 맵 스타일의 기본 색상이 적용됩니다. ## 그리기 순서 사용자 지정 오버레이는 명확성을 유지하고 시각적 혼잡을 방지하기 위해 특정 순서로 그려집니다. Amazon Location Service에서는 다각형, 선 및 점과 같은 오버레이 기능이 기본 맵 위에 표시되지만 맵 레이블 아래에 표시됩니다. 그리기 순서는 다각형의 우선 순위를 먼저 지정한 다음, 선, 점 또는 마커를 차례로 지정합니다. ## 측정 단위 `width` 및 `outline-width`와 같은 속성의 경우 다양한 측정 단위를 사용하여 픽셀(px), 미터(m), 킬로미터(km), 마일(mi) 및 백분율(%)을 포함한 크기를 지정할 수 있습니다. 백분율 단위는 기본값을 기준으로 속성을 조정하므로 오버레이를 보다 유연하게 스타일 지정할 수 있습니다. ## 지오메트리 유형 Amazon Location Service는 `Point`, `LineString`, `Polygon` 및 `MultiPolygon`과 같은 여러 GeoJSON 지오메트리 유형을 지원합니다. GeoJSON의 속성 객체를 사용하여 각 지오메트리 유형을 스타일 지정하고 조정할 수 있으므로 맵의 마커, 경로 및 영역을 광범위하게 사용자 지정할 수 있습니다. ## 압축 오버레이 사용 **참고** 소형 오버레이는 점, 선, 다각형 등의 지오메트리 유형을 지원합니다. `multiPoint`, `multiLine` 또는 `multiPolgyon`을 지원하지 않습니다. 압축 오버레이 옵션을 사용하면 단일 쿼리 파라미터를 사용하여 정적 맵에 여러 지오메트리를 효율적으로 표시할 수 있습니다. 이렇게 간소화된 접근 방식은 요청 형식을 간소화하고 요청 크기를 줄여 오버레이 데이터를 더 쉽게 전송할 수 있습니다. 고객은 쿼리 파라미터 하나에 다양한 지오메트리 유형과 해당 스타일 속성을 입력할 수 있으며, Amazon Location Service는 오버레이를 지정된 대로 구문 분석하고 렌더링하여 과도한 작업을 처리합니다. 압축 오버레이 형식을 사용하는 동안 요청 URL 크기에 제한이 있다는 점에 유의하세요. Amazon Location Service는 쿼리를 최적화하지만 특히 여러 지오메트리 및 관련 속성을 처리할 때 요청이 적절한 한도 내에 있는지 확인합니다. ## 형식 압축 오버레이 형식은 다음과 같이 구성됩니다. `geometry_type:geometry;property_1=value_1;property_2=value_2|geometry_type:geometry;property_1=value_1...` 각 지오메트리 유형은 스타일 속성과 함께 정의됩니다. 여러 지오메트리는 파이프 연산자(\$1)로 구분되며 각 지오메트리의 속성은 세미콜론을 사용하여 구분됩니다. ## 지원되는 지오메트리 유형 Amazon Location Service는 `Point`, `MultiPoint`, `LineString`, `Polygon`, `MultiPolygon` 등 여러 지오메트리 유형을 지원합니다. 이러한 지오메트리 유형은 압축 오버레이 형식을 사용하여 동일한 쿼리 파라미터 내에서 결합하고 스타일을 지정할 수 있습니다. ## 스타일 속성 색상, 윤곽선 색상, 크기 등과 같은 다양한 스타일 속성을 사용하여 각 지오메트리를 사용자 지정할 수 있습니다. 이러한 속성을 사용하면 맵에서 각 지오메트리의 모양을 제어하여 오버레이가 비즈니스 요구 사항에 부합하는지 확인할 수 있습니다.