Ikony miejsc

Wybierz platformę: Android iOS JavaScript Usługa internetowa

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 wartość .svg lub .png.
• Kolor tła ikony zawiera domyślny szesnastkowy kod koloru kategorii miejsca.

Adresy URL ikon mogą się zmieniać, dlatego zawsze używaj identyfikatora URI podstawowego ikony, aby wyszukać adres URL ikony. Dotychczasowy interfejs Places API obsługuje pole odpowiedzi icon. Nie używaj pola icon, ale zamiast niego używaj pól icon_background_color i icon_mask_base_uri w obecnym interfejsie Places API.

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. Zwróć uwagę, że żądanie i odpowiedzi są różne w przypadku obu wersji interfejsu API.

Places API (nowość)

W tym przykładzie użyto zapytania Wyszukiwanie tekstowe (nowe), aby zwrócić nazwę wyświetlaną 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 postać:

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

Przykład poniżej 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

Ten 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ę, 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 tabeli 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 (podstawowa, średnia, uniwersytet)	Kult (chrześcijański)
Kult (hinduizm)	Kult (islam)	Kult (dżainizm)	Uwielbienie (żydowskie)
Kult (Sikhizm)	Ogólna działalność
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