장소 아이콘

플랫폼 선택: Android iOS JavaScript 웹 서비스

장소 아이콘은 다양한 유형의 장소 (예: 커피숍, 볼 수 있습니다. PNG 또는 SVG 형식의 아이콘 URL을 요청할 수 있으며, 해당 아이콘 배경 색상도 볼 수 있습니다. 장소 찾기에서는 장소 세부정보, 주변 검색, 텍스트 검색 요청 아이콘은 인라인으로 사용할 수 있습니다.

각 아이콘은 두 개의 응답 필드로 정의됩니다.

  • 아이콘 기본 URI에 색상이 지정되지 않은 항목의 기본 URL이 포함되어 있습니다. 아이콘에서 파일 형식 확장자를 뺀 값입니다. .svg 또는 .png를 URI에 추가하여 아이콘을 요청합니다.
  • 아이콘 배경 색상에는 다음 항목의 기본 16진수 색상 코드가 포함됩니다. 장소의 카테고리입니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.

예

다음 예는 Places API (신규) 및 Places API입니다. 요청과 응답이 서로 다르다는 것을 알 수 있습니다. 에 대한 설명을 제공합니다.

Places API(신규)

다음 예에서는 텍스트 검색 (신규) 를 사용하여 장소의 표시 이름과 iconMaskBaseUri 및 iconBackgroundColor 응답 필드:

curl -X POST -d '{
  "textQuery" : "skog haus",
  "maxResultCount" : 1
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.iconMaskBaseUri,places.iconBackgroundColor' \
'https://places.googleapis.com/v1/places:searchText'

응답은 다음과 같은 형식입니다.

{
  "places": [
    {
      "iconMaskBaseUri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet",
      "iconBackgroundColor": "#FF9E67",
      "displayName": {
        "text": "SKÖG Haus Coffee & Tea",
        "languageCode": "en"
      }
    }
  ]
}

Places API

다음 예는 장소 찾기 요청 여기에는 icon_mask_base_uri 및 icon_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=API_KEY

다음 예는 장소 찾기 요청의 응답에 icon_mask_base_uri 및 icon_background_color 필드가 표시되는 방식을 보여줍니다.

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>

아이콘을 표시하려면 반환된 아이콘에 원하는 파일 형식 확장자 (.png 또는 .svg)를 추가하세요. URI를 설정하고 아이콘을 반환된 배경색과 결합합니다. 예를 들어 .svg 아이콘을 표시하려면 :

<style>
  .icons-food-drink {
    background-color: #FF9E67;
    width: 88px;
    height: 88px;
    padding: 5px;
  }
</style>

<img src="https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet.svg" alt="Cafe" class="icons-food-drink"/>

장소 아이콘 및 배경색 요청

다음 표에는 사용 가능한 모든 장소 아이콘이 카테고리별로 나와 있습니다. 기본적으로 이러한 장소 아이콘은 검은 글리프로 표시됩니다. 아이콘 배경 색상은 장소의 카테고리에 따라 결정됩니다.

장소 카테고리: 식음료
(아이콘 배경색 #FF9E67)
바
바,
나이트클럽 		카페
카페 		음식점
음식점, 제과점
장소 카테고리: 소매
(아이콘 배경색 #4B96F3)
서점
도서, 의류, 전자제품, 보석, 신발,
쇼핑 센터/몰 		편의점
편의점 		식료품점
식료품점, 슈퍼마켓 		약국
약국
장소 카테고리: 서비스
(아이콘 배경 #909CE1)
ATM
ATM 		은행
은행 		주유소
주유소 		숙박시설
숙박시설
우체국
우체국
장소 카테고리: 엔터테인먼트
(아이콘 배경색 #13B5C7)
수족관, 관광명소
수족관, 관광명소 		골프
골프 		유적지
유적지 		영화
영화
박물관
박물관 		극장
극장
장소 카테고리: 교통
(아이콘 배경색 #10BDFF)
공항
공항 		버스
버스, 차량 공유, 택시 		기차/철도
기차/철도
장소 카테고리: 시/일반/종교
(아이콘 배경색 #7B9EB0)
묘지
묘지 		관청 건물
관청 건물 		도서관
도서관 		기념비
기념비
주차장
주차장 		학교(초등학교, 중고등학교, 대학교)
학교(초등학교, 중고등학교, 대학교) 		예배당(기독교)
예배당(기독교)
예배당(힌두교)
예배당(힌두교) 		예배당(이슬람교)
예배당(이슬람교) 		예배당(자이나교)
예배당(자이나교) 		예배당(유대교)
예배당(유대교)
예배당(시크교)
예배당(시크교) 		일반 비즈니스
일반 비즈니스
장소 카테고리: 실외
(아이콘 배경색 #4DB546)
보트 타기
보트 타기 		캠핑
캠핑 		공원
공원 		경기장
경기장
동물원
동물원
장소 카테고리: 응급
(아이콘 배경색 #F88181)
병원
병원 		경찰서
경찰서