장소 아이콘은 다양한 유형의 장소 (예: 커피숍, 도서관, 박물관)를 나타냅니다. Find Place, Place Details, Nearby Search, Text Search 요청을 사용하여 PNG 또는 SVG 형식의 아이콘 URL과 해당하는 아이콘 배경 색상을 요청할 수 있습니다. 아이콘은 인라인으로 사용할 수 있습니다.
다음 예는 icon_mask_base_uri
및 icon_background_color
필드가 포함된 Find Place 요청을 보여줍니다.
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=skog%20haus&inputtype=textquery&fields=name,icon_mask_base_uri,icon_background_color&key=YOUR_API_KEY
응답 예
다음 예는 장소 찾기 요청의 응답에 icon_mask_base_uri
및 icon_background_color
필드가 표시되는 방식을 보여줍니다. URL을 사용하려면 원하는 파일 형식 확장자(.png 또는 .svg)를 추가하세요.
JSON
{ "candidates" : [ { "icon_background_color" : "#FF9E67", "icon_mask_base_uri" : "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet", "name" : "SKÖG Haus Coffee", } ], "status" : "OK" }
XML
<FindPlaceFromTextResponse> <candidates> <name>SKÖG Haus Coffee</name> <icon_background_color>#FF9E67</icon_background_color> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet</icon_mask_base_uri> </candidates> <status>OK</status> </FindPlaceFromTextResponse>
필드
각 장소 아이콘에는 다음과 같은 필드가 포함됩니다.
icon
은 색상이 지정된 71x71픽셀 PNG 아이콘의 URL을 반환합니다.icon_mask_base_uri
는 색상이 지정되지 않은 아이콘의 기본 URL에서 파일 형식 확장자를 뺀 값을 반환합니다 (.svg
또는.png
추가).icon_background_color
는 장소 카테고리의 기본 16진수 색상 코드를 반환합니다.
장소 아이콘 및 배경색 요청
다음 표에는 사용 가능한 모든 장소 아이콘이 카테고리별로 나와 있습니다. 기본적으로 이러한 장소 아이콘은 검은 글리프로 표시됩니다. icon_background_color
는 장소의 카테고리에 따라 결정됩니다.
장소 카테고리: 식음료 (아이콘 배경색 #FF9E67) |
|||
---|---|---|---|
바, 나이트클럽 |
카페 |
음식점, 제과점 |
|
장소 카테고리: 소매 (아이콘 배경색 #4B96F3) |
|||
도서, 의류, 전자제품, 보석, 신발, 쇼핑 센터/몰 |
![]() 편의점 |
식료품점, 슈퍼마켓 |
약국 |
장소 카테고리: 서비스 (아이콘 배경 #909CE1) |
|||
ATM |
은행 |
주유소 |
숙박시설 |
우체국 |
|||
장소 카테고리: 엔터테인먼트 (아이콘 배경색 #13B5C7) |
|||
수족관, 관광명소 |
골프 |
과거 |
영화 |
박물관 |
극장 |
||
장소 카테고리: 교통 (아이콘 배경색 #10BDFF) |
|||
공항 |
버스, 차량 공유, 택시 |
기차/철도 |
|
장소 카테고리: 시/일반/종교 (아이콘 배경색 #7B9EB0) |
|||
묘지 |
관청 건물 |
라이브러리 |
기념물 |
주차 |
학교(초등학교, 중고등학교, 대학교) |
예배당(기독교) |
|
예배당(힌두교) |
예배당(이슬람교) |
예배당(자이나교) |
예배당(유대교) |
예배당(시크교) |
일반 비즈니스 |
||
장소 카테고리: 실외 (아이콘 배경색 #4DB546) |
|||
보트 |
캠핑 |
공원 |
경기장 |
동물원 |
|||
장소 카테고리: 응급 (아이콘 배경색 #F88181) |
|||
병원 |
경찰서 |