Ikony miejsc

Wprowadzenie

Ikony miejsc wskazują różne typy miejsc (np. kawiarnie, biblioteki i muzea). Za pomocą żą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 odpowiednie kolory tła ikon. Ikony można umieszczać w tekście.

Każda ikona jest definiowana przez 2 pola odpowiedzi:

• Identyfikator URI bazowy ikony zawiera podstawowy adres URL niekolorowej ikony bez rozszerzenia typu pliku. Aby poprosić o ikonę, musisz dodać do identyfikatora URI .svg lub .png.
• Kolor tła ikony zawiera domyślny szesnastkowy kod koloru kategorii miejsca.

Przykład

Te przykłady pokazują, jak poprosić o identyfikator URI ikony i kolor tła w przypadku interfejsu Places API (New) i Places API (Legacy). Zwróć uwagę, że żądanie i odpowiedzi są różne w przypadku obu wersji interfejsu API.

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"
      }
    }
  ]
}

    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

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

    <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ę, dodaj do zwróconego identyfikatora URI ikony rozszerzenie typu pliku (.png lub .svg) i połącz ikonę z 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 pogrupowane według kategorii. Domyślnie są one wyświetlane z czarnym symbolem. Kolor tła ikony jest określony przez kategorię miejsca.

Kategoria miejsca: jedzenie i napoje (kolor tła ikony: #FF9E67)
Bar, Klub nocny	Kawiarnia	Restauracja, piekarnia
Kategoria miejsca: Handel detaliczny (kolor tła ikony #4B96F3)
Książki, odzież, elektronika, biżuteria, obuwie, Centrum handlowe	Sklep osiedlowy	Sklep spożywczy, supermarket	Apteka
Kategoria miejsca: Usługi (kolor tła ikony: #909CE1)
Bankomat	Bank	Gaz	Noclegi
Urząd pocztowy
Kategoria miejsca: rozrywka (kolor tła ikony #13B5C7)
Aquarium, Tourist	Golf	Historyczne	Film
Muzeum	Teatr
Kategoria miejsca: Transport (kolor tła ikony: #10BDFF)
Lotnisko	Autobus, wspólne przejazdy, taksówki	Pociągi/Kolej
Kategoria miejsca: gmina/ogólne/religijne (ikona z tłem w kolorze #7B9EB0)
Cmentarz	Budynek użyteczności publicznej	Biblioteka	Pomnik
Parking	Szkoła (szkoła podstawowa, szkoła średnia, uniwersytet)	Kult (chrześcijański)
Kult (hinduizm)	Kult (islam)	Kult (dżainizm)	Uwielbienie (żydowskie)
Kult (Sikhizm)	Generic business
Kategoria miejsca: na świeżym powietrzu (kolor tła ikony: #4DB546)
Żeglarstwo	Kemping	Park	Stadion
Zoo
Kategoria miejsca: awaryjne (kolor tła ikony: #F88181)
Szpital	Policja