장소 아이콘

플랫폼 선택: Android iOS 자바스크립트 웹 서비스

장소 아이콘은 다양한 유형의 장소 (예: 커피숍, 도서관, 박물관)를 나타냅니다. 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

응답 예

다음 예는 Find Place 요청의 응답에 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 ATM
 은행
은행 		주유소
가스 		숙박시설
숙박시설
우체국
우체국
장소 카테고리: 엔터테인먼트
(아이콘 배경색 #13B5C7)
수족관, 관광명소
수족관, 관광명소 		골프
골프 		유적지
역사적 		영화
영화
박물관
박물관 		극장
극장
장소 카테고리: 교통
(아이콘 배경색 #10BDFF)
공항
공항 		버스
버스, 차량 공유, 택시 		기차/철도
기차/철도
장소 카테고리: 시/일반/종교
(아이콘 배경색 #7B9EB0)
묘지
묘지 		관청 건물
관공서 		도서관
라이브러리 		기념비
기념비
주차장
주차 		학교(초등학교, 중고등학교, 대학교)
학교(초등학교, 중고등학교, 대학교) 		예배당(불교)
예배당(불교) 		예배당(기독교)
예배당(기독교)
예배당(힌두교)
예배당(힌두교) 		예배당(이슬람교)
예배당(이슬람교) 		예배당(자이나교)
예배당(자이나교) 		예배당(유대교)
예배당(유대교)
예배당(시크교)
예배당(시크교) 		일반 비즈니스
일반 비즈니스
장소 카테고리: 실외
(아이콘 배경색 #4DB546)
보트 타기
보트 		캠핑
캠핑 		공원
공원 		경기장
경기장
동물원
동물원
장소 카테고리: 응급
(아이콘 배경색 #F88181)
병원
병원 		경찰서
경찰서