Ikony miejsca

Ikony miejsc wskazują różne rodzaje miejsc (np. kawiarnie, biblioteki i muzea). W przypadku żądań Znajdź miejsce, Szczegóły miejsca, Wyszukiwanie w pobliżu i wyszukiwanie tekstowe możesz poprosić o adresy URL ikon w formacie PNG lub SVG, a także o odpowiedni kolor tła ikony. Ikon możesz używać w tekście.

Każda ikona jest definiowana przez 2 pola odpowiedzi:

  • Podstawowy identyfikator URI ikon zawiera podstawowy adres URL ikony bez koloru pomniejszonej o rozszerzenie typu pliku. Aby zażądać ikony, musisz do identyfikatora URI dołączyć atrybut .svg lub .png.
  • Kolor tła ikony to domyślny szesnastkowy kod koloru kategorii miejsca.

Przykład

W przykładach poniżej pokazujemy, jak zażądać identyfikatora URI ikony i koloru tła w interfejsach Places API (New) i Places API. Zwróć uwagę, że żądanie i odpowiedzi są różne w obu wersjach interfejsu API.

Places API (nowość)

W tym przykładzie użyto funkcji Wyszukiwanie tekstowe (nowość), aby zwrócić wyświetlaną nazwę miejsca oraz pola odpowiedzi iconMaskBaseUri i 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'

Odpowiedź ma taki format:

{
  "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

Poniższy przykład przedstawia żądanie Znajdź miejsce, które zawiera pola icon_mask_base_uri i 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

Poniższy przykład pokazuje, jak pola icon_mask_base_uri i icon_background_color wyglądają w odpowiedzi na żądanie Znajdź miejsce.

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>
          

Aby wyświetlić ikonę, dołącz wybrane rozszerzenie typu pliku (.png lub .svg) do zwróconej ikony identyfikatora URI i połącz ikonę ze zwróconym kolorem tła. Aby na przykład wyświetlić ikonę .svg na stronie internetowej:

<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"/>

Prośby o kolor ikony i tła

W tabelach poniżej znajdziesz wszystkie dostępne ikony miejsc według kategorii. Domyślnie są one wyświetlane z czarnym glifem. Kolor tła ikony jest określany na podstawie kategorii miejsca.

Kategoria miejsca: Jedzenie i napoje
(kolor tła ikony #FF9E67)
Słupkowy
Bar,
Klub nocny
Kawiarnia
Kawiarnia
restauracja,
Restauracja, piekarnia
Kategoria miejsca: handel detaliczny
(kolor tła ikony #4B96F3)
Księgarnia
Książki, odzież, elektronika, biżuteria, buty,
centrum handlowe
Sklep wielobranżowy
Sklep wielobranżowy
Sklep spożywczy
Sklep spożywczy, supermarket
Apteka
Apteka
Kategoria miejsca: usługi
(kolor tła ikony #909CE1)
Bankomat
Bankomat
Bank
Bank
Stacje paliw
Gaz
Zakwaterowanie
Zakwaterowanie
Urząd pocztowy
Poczta
Kategoria miejsca: Rozrywka
(kolor tła ikony #13B5C7)
Oceanarium, turysta
Oceanarium, Turysta
Golf
Golf
Pismo historyczne
Historyczne
Film
Film
Muzeum
Muzeum
Teatr
Kino
Kategoria miejsca: Transport
(kolor tła ikony #10BDFF)
Port lotniczy
Lotnisko
Autobus
Autobus, wspólne przejazdy, taksówka
Pociąg
Pociąg
Kategoria miejsca: Miejskie/ogólne/religijne
(icon background color #7B9EB0)
Cmentarz
Cmentarz
Budynek władz miejskich
Budynek miejski
Biblioteka
Biblioteka
Pomnik
Pomnik
Parking
Parking
Szkoła (podstawowa, średnia, uniwersytet)
Szkoła (szkoła podstawowa, średnia, uczelnia wyższa)
Praktyki chrześcijańskie
Modlitwa (chrześcijanin)
Praktyki religijne (hinduskie)
Uwielbienie (hinduskie)
Kult (islam)
Uwielbienie (islam)
Kult (Jain)
Wiedza (Jain)
Oddawanie czci (żydów)
Oddawanie czci (żydów)
Oddawanie czci (sikhów)
Oddawanie czci (sikhów)
Ogólna firma
Typowa firma
Kategoria miejsca: Na zewnątrz
(icon background color #4DB546)
Łodzią
Pływanie łodzią
Kemping
Kemping
Park
Park
Stadion
Stadion
Zoo
Zoo
Kategoria miejsca: alarmowe
(kolor tła ikony #F88181)
Szpital
Szpital
Policja
Policja