Maps Static API를 사용할 때 나만의 스타일을 적용하여 표준 Google 지도의 표현을 맞춤설정하세요. 도로, 공원, 시가지 및 기타 관심 장소와 같은 지형지물의 시각적 표시를 변경할 수 있습니다. 특정 콘텐츠를 강조하기 위해 색상이나 스타일을 변경하거나, 페이지의 주변 콘텐츠를 보완하거나, 지형지물을 완전히 숨길 수도 있습니다.
예
다음 예는 지역 도로를 밝은 녹색으로, 주거 지역은 검은색으로 지정하는 스타일이 지정된 미국 브루클린의 지도를 표시합니다. 또한 라벨의 밝기를 반전하여 어두운 배경에서 더 잘 보이게 합니다. 이 작업 샘플은 URL 인코딩을 사용합니다.
https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=15¢er=Brooklyn&style=feature:road.local%7Celement:geometry%7Ccolor:0x00ff00&style=feature:landscape%7Celement:geometry.fill%7Ccolor:0x000000&style=element:labels%7Cinvert_lightness:true&style=feature:road.arterial%7Celement:labels%7Cinvert_lightness:false&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
![브루클린 스타일 지도](https://developers.google.cn/static/maps/documentation/maps-static/images/brooklyn-map.png?authuser=8&hl=ko)
다음 예에서는 스타일 지정 작업과 단순화를 사용하여 미국 도로 지도 모양을 대략적으로 표시합니다.
https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=12¢er=Chicago&format=png&style=feature:road.highway%7Celement:geometry%7Cvisibility:simplified%7Ccolor:0xc280e9&style=feature:transit.line%7Cvisibility:simplified%7Ccolor:0xbababa&style=feature:road.highway%7Celement:labels.text.stroke%7Cvisibility:on%7Ccolor:0xb06eba&style=feature:road.highway%7Celement:labels.text.fill%7Cvisibility:on%7Ccolor:0xffffff&key=YOUR_API_KEY&signature=DITIGAL_SIGNATURE
![미국 도로 지도 스타일입니다.](https://developers.google.cn/static/maps/documentation/maps-static/images/us-road-atlas-map.png?authuser=8&hl=ko)
스타일 구문
맞춤설정된 스타일 지도를 만들려면 요청 URL에 하나 이상의 style
매개변수를 포함합니다.
각 style
선언에는 파이프 문자 ('|
')로 구분된 다음 인수가 포함될 수 있습니다.
feature
(선택사항)은 이 스타일 수정에서 선택할 지형지물을 나타냅니다. 지형지물에는 도로, 공원, 기타 관심 장소 등 지도상의 사물이 포함됩니다.feature
인수가 없으면 지정된 스타일이 모든 지형지물에 적용됩니다.element
(선택사항)은 이 스타일 수정에서 선택할 지정된 지형지물의 요소를 나타냅니다. 요소는 도형이나 라벨과 같은 지형지물의 특성입니다.element
인수가 없으면 지정된 지형지물의 모든 요소에 스타일이 적용됩니다.- 지정된 지형지물 및 요소에 적용할 스타일 규칙 집합(필수)입니다. API는
style
선언에 표시되는 순서대로 규칙을 적용합니다. Maps Static API의 일반 URL 길이 제약 조건 내에서 규칙을 얼마든지 포함할 수 있습니다.
style=feature:myFeatureArgument|element:myElementArgument|myRule1:myRule1Argument|myRule2:myRule2Argument
기능
다음 style
선언은 지도의 모든 도로에 색상을 지정합니다.
style=feature:road|color:0xffffff
일반적인 지형지물 선택 항목은 다음과 같습니다.
feature:all
(기본값)은 지도의 모든 지형지물을 선택합니다.feature:road
에서는 지도의 모든 도로를 선택합니다.feature:road.local
에서는 모든 지방 도로를 선택합니다.
지형지물 또는 지형지물 유형은 지도상의 지리적 특성에 해당되며 여기에는 도로, 공원, 호수/바다, 비즈니스 등이 포함됩니다.
지형지물은 all
을
루트로 사용하는 카테고리 트리를 형성합니다. 지형지물을 지정하지 않으면 모든 지형지물이 선택됩니다.
지형지물을 all
로 지정하는 경우에도 동일한 효과가 나타납니다.
일부 지형지물에는 점(.) 표기법을 사용하여 지정하는
하위 지형지물이 포함됩니다. 예를 들면 landscape.natural
또는
road.local
입니다. 상위 지형지물만 지정하는 경우(예: road
)
상위 요소에 지정한 스타일이 모든
하위 요소(예: road.local
, road.highway
)에
적용됩니다.
참고로, 상위 지형지물에는 일부 하위 지형지물에는 포함되지 않은 요소가 일부 포함될 수도 있습니다.
사용할 수 있는 지형지물은 다음과 같습니다.
all
(기본값)은 모든 지형지물을 선택합니다.administrative
에서는 모든 행정 구역을 선택합니다. 스타일 지정은 행정 구역의 라벨에만 영향을 미치며 지리적 경계나 채우기에는 영향을 미치지 않습니다.administrative.country
에서는 국가를 선택합니다.administrative.land_parcel
에서는 필지를 선택합니다.administrative.locality
에서는 지역을 선택합니다.administrative.neighborhood
에서는 주변 지역을 선택합니다.administrative.province
에서는 주/도를 선택합니다.
landscape
에서는 모든 풍경을 선택합니다.landscape.man_made
에서는 건물, 기타 구조물 등 인공 지형지물을 선택합니다.landscape.natural
에서는 산, 강, 사막, 빙하 등 자연 지형지물을 선택합니다.landscape.natural.landcover
에서는 삼림, 초원, 습지, 지면 등 지표면을 덮는 육상 지형지물과 물리적 대상을 선택합니다.landscape.natural.terrain
에서는 고도, 경사, 방향 등 지표면의 지형지물을 선택합니다.
poi
에서는 모든 관심 장소를 선택합니다.poi.attraction
에서는 관광명소를 선택합니다.poi.business
에서는 비즈니스를 선택합니다.poi.government
에서는 정부 건물을 선택합니다.poi.medical
에서는 병원, 약국, 경찰서, 의사 등 응급 서비스를 선택합니다.poi.park
에서는 공원을 선택합니다.poi.place_of_worship
에서는 교회, 사원, 모스크 등 예배 장소를 선택합니다.poi.school
에서는 학교를 선택합니다.poi.sports_complex
에서는 스포츠 단지를 선택합니다.
road
에서는 모든 도로를 선택합니다.road.arterial
에서는 간선도로를 선택합니다.road.highway
에서는 고속도로를 선택합니다.road.highway.controlled_access
에서는 접근이 통제된 고속도로를 선택합니다.road.local
에서는 지방도를 선택합니다.
transit
에서는 모든 대중교통 역과 노선을 선택합니다.transit.line
에서는 대중교통 노선을 선택합니다.transit.station
에서는 모든 대중교통 역을 선택합니다.transit.station.airport
에서는 공항을 선택합니다.transit.station.bus
에서는 버스 정류장을 선택합니다.transit.station.rail
에서는 기차역을 선택합니다.
water
에서는 호수/바다를 선택합니다.
요소
다음 style
선언은 모든 지역 도로의 라벨에 색상을 지정합니다.
style=feature:road.local|element:labels|color:0xffffff
요소는 한 지형지물의 세부 구획을 나타냅니다. 예를 들어 도로는 지도상의 그래픽 선(도형)과 그 이름(라벨)을 표시하는 텍스트로 구성됩니다.
다음과 같은 요소를 사용할 수 있으며 다만 특정 지형지물은 어떤 요소도 사용하지 않거나 일부 또는 모든 요소를 사용할 수도 있습니다.
all
(기본값)에서는 지정된 지형지물의 모든 요소를 선택합니다.geometry
에서는 지정된 지형지물의 모든 도형 요소를 선택합니다.geometry.fill
에서는 지형지물 도형의 채우기만 선택합니다.geometry.stroke
에서는 지형지물 도형의 획만 선택합니다.
labels
에서는 지정된 지형지물과 관련된 텍스트 라벨을 선택합니다.labels.icon
에서는 지형지물 라벨 내에 표시된 아이콘만 선택합니다.labels.text
에서는 라벨의 텍스트만 선택합니다.labels.text.fill
에서는 라벨의 채우기만 선택합니다. 라벨의 채우기는 대체로 라벨 텍스트를 둘러싼 컬러 윤곽선으로 렌더링됩니다.labels.text.stroke
에서는 라벨 텍스트의 획만 선택합니다.
스타일 규칙
스타일 규칙은 각 style
선언에 지정된 지형지물과 요소에
적용되는 형식 지정 옵션입니다.
다음 style
선언은 지도의 도로에 두 가지 스타일 규칙을 적용합니다. 첫 번째 규칙은 도로에 색상을 적용합니다. 두 번째 규칙은 도로 표시를 간소화하여 윤곽선이 없는 얇은 선을 사용합니다.
style=feature:road|color:0xffffff|visibility:simplified
각 style
선언에는 파이프 ('|
') 문자를 사용하여 구분된 하나 이상의 작업이 포함되어야 합니다. 각 작업은 콜론 (':
') 문자를 사용하여 인수 값을 지정하며 모든 작업은 지정된 순서대로 선택사항에 적용됩니다.
다음과 같은 스타일 옵션이 지원됩니다.
hue
(#RRGGBB
형식의 RGB 16진수 문자열)에서는 기본 색상을 나타냅니다.참고: 이 옵션은 기본 Google 스타일에 지정된(또는 지도에 정의한 기타 스타일 옵션에 지정된) 채도와 밝기를 유지하면서 색조를 설정합니다. 실제 색상은 기본 지도 스타일과 관련이 있습니다. Google에서 기본 지도 스타일을 변경하면
hue
로 스타일이 지정된 지도 지형지물에 변경사항이 적용됩니다. 가능하다면 꼭color
스타일러를 사용하는 것이 좋습니다.lightness
(-100
및100
사이의 부동 소수점 값)에서는 요소 밝기의 비율 변화를 나타냅니다. 음수 값은 어둡게 하고(-100은 검은색을 지정) 양수 값은 밝게 합니다(+100은 흰색을 지정).참고: 이 옵션은 기본 Google 스타일에 지정된(또는 지도에 정의한 기타 스타일 옵션에 지정된) 채도와 색조를 유지하면서 밝기를 설정합니다. 실제 색상은 기본 지도 스타일과 관련이 있습니다. Google에서 기본 지도 스타일을 변경하면
lightness
로 스타일이 지정된 지도 지형지물에 변경사항이 적용됩니다. 가능하다면 꼭color
스타일러를 사용하는 것이 좋습니다.saturation
(-100
및100
사이의 부동 소수점 값)에서는 요소에 적용될 기본 색상 강도의 비율 변화를 나타냅니다.참고: 이 옵션은 기본 Google 스타일에 지정된(또는 지도에 정의한 기타 스타일 옵션에 지정된) 색조와 밝기를 유지하면서 채도를 설정합니다. 실제 색상은 기본 지도 스타일과 관련이 있습니다. Google에서 기본 지도 스타일을 변경하면
saturation
으로 스타일이 지정된 지도 지형지물에 변경사항이 적용됩니다. 가능하다면 꼭color
스타일러를 사용하는 것이 좋습니다.gamma
(0.01
및10.0
사이의 부동 소수점 값)에서는 요소에 적용할 감마 보정의 양을 나타냅니다(1.0
이면 정정을 적용 안 함). 감마 보정은 비선형 방식으로 색상의 밝기를 수정하며 흑백 값에는 영향을 미치지 않습니다. 감마 보정은 대체로 여러 요소의 대비를 수정하는 데 사용됩니다. 예를 들어 감마값을 변경하여 요소 가장자리와 요소 내부 사이의 대비를 늘리거나 줄일 수 있습니다.참고: 이 옵션에서는 감마 곡선을 사용하여 기본 Google 스타일에 대해 상대적인 밝기를 조정합니다. Google에서 기본 지도 스타일을 변경하면
gamma
로 스타일이 지정된 지도 지형지물에 변경사항이 적용됩니다. 가능하다면 절대color
스타일러를 사용하는 것이 더 좋습니다.invert_lightness
(true
인 경우)에서는 기존 밝기를 반전시킵니다. 이 옵션은 예를 들면 흰색 텍스트가 포함된 어두운 지도로 빠르게 전환할 때 유용합니다.참고: 이 옵션은 기본 Google 스타일을 반전시킵니다. Google에서 기본 지도 스타일을 변경하면
invert_lightness
로 스타일이 지정된 지도 지형지물에 변경사항이 적용됩니다. 가능하다면 절대color
스타일러를 사용하는 것이 더 좋습니다.visibility
(on
,off
또는simplified
)에서는 요소가 지도에 표시되는지 여부 및 표시 방식을 나타냅니다.simplified
가시성은 영향을 받는 지형지물에서 스타일 지형지물을 제거합니다. 예를 들어 도로는 윤곽선 없는 얇은 선으로 간소화되지만 공원의 경우 라벨 텍스트가 없어지되 라벨 아이콘은 그대로 유지됩니다.color
(#RRGGBB
형식의 RGB 16진수 문자열)에서는 지형지물 색상을 설정합니다.weight
(0 이상의 정수 값)에서는 지형지물의 가중치를 픽셀로 지정합니다. 가중치를 높은 값으로 설정하면 타일 테두리 근처가 잘릴 수도 있습니다.
스타일 규칙은 지정된 순서대로 적용됩니다. 여러 작업을 단일 스타일 작업으로 병합하지 마십시오. 그 대신, 각 작업을 별도의 항목으로 스타일 배열에 정의하세요.
참고: 일부 작업은 교환 법칙이 적용되지 않으므로 순서가 중요합니다. 스타일 작업을 통해 수정되는 지형지물 및 요소들은 (대체로) 이미 기존 스타일이 있습니다. 기존 스타일이 있다면 해당 스타일에 작업이 진행됩니다.
색조, 채도, 밝기 모델
스타일 지도는 색조, 채도, 명도(HSL) 모델을 사용하여 스타일러 작업 내에 색상을 표시합니다. 색조는 기본 색상을 나타내고 채도는 색상의 강도를 나타내며 밝기는 색상 구성요소 중 흰색 또는 검은색의 상대적인 양을 나타냅니다.
감마
보정은 색 공간에서 밝기를 수정하며 일반적으로
대비를 늘리거나 줄입니다. 또한 HSL 모델은 좌표 공간 내에 있는 색상을
정의합니다. 여기에서 hue
는 색상환 내 방향을
나타내며 채도와 밝기는 서로 다른 축에 따른 진폭을
나타냅니다. 색조는 RGB 색 공간 내에서 측정되며 이 색 공간은 흑백의 명암이 없다는 점을 제외하고는 대부분의 RGB 색 공간과 유사합니다.
hue
는 HTML 16진수 색상 값을 취하기는 하지만
이 값은 기본 색상(즉, 색상환에서의 방향)을 결정하는 데만
사용되며 채도나 밝기는 결정하지 않습니다. 채도나 밝기는
백분율로 따로 표시됩니다.
예를 들어 순수 녹색의 색조를
hue:0x00ff00
또는 hue:0x000100
으로 정의할 수 있습니다. 두 색조는
동일합니다. 두 값은 HSL 색상 모델에서 순수 녹색을 가리킵니다.
RGB 색상환
균등한 부분의 빨강, 녹색 및 파랑으로 구성되는
RGB hue
값은 색조를 나타내지 않는데, 그 이유는 이러한 값이 HSL 좌표 공간에서
방향을 나타내지 않기 때문입니다. 예를 들면 '#000000'(검은색), '#FFFFFF'(흰색),
회색의 모든 순수 음영이 있습니다. 검은색, 흰색 또는 회색을 나타내려면
모든 saturation
(값을 -100
으로 설정)을 삭제하고
그 대신 lightness
를 조정해야 합니다.
또한 이미 색 구성표가 있는 기존 지형지물을 수정할 때
hue
등의 값을 변경해도 기존 saturation
또는 lightness
는
변경되지 않습니다.