장소 아이콘

장소 아이콘은 다양한 유형의 장소(예: 커피숍, 도서관, 박물관)를 나타냅니다. 장소 찾기, 장소 세부정보, 주변 검색, 텍스트 검색 요청을 사용하여 PNG 또는 SVG 형식의 아이콘 URL 및 해당하는 아이콘 배경색을 요청할 수 있습니다. 아이콘은 인라인으로 사용할 수 있습니다.

다음 예는 icon_mask_base_uriicon_background_color 필드가 포함된 장소 찾기 요청의 예를 보여줍니다.

    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_uriicon_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)
병원
병원
경찰서
경찰서