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) |
|||
---|---|---|---|
Bar, Klub nocny |
Kawiarnia |
Restauracja, piekarnia |
|
Kategoria miejsca: handel detaliczny (kolor tła ikony #4B96F3) |
|||
Książki, odzież, elektronika, biżuteria, buty, centrum handlowe |
Sklep wielobranżowy |
Sklep spożywczy, supermarket |
Apteka |
Kategoria miejsca: usługi (kolor tła ikony #909CE1) |
|||
Bankomat |
Bank |
Gaz |
Zakwaterowanie |
Poczta |
|||
Kategoria miejsca: Rozrywka (kolor tła ikony #13B5C7) |
|||
Oceanarium, Turysta |
Golf |
Historyczne |
Film |
Muzeum |
Kino |
||
Kategoria miejsca: Transport (kolor tła ikony #10BDFF) |
|||
Lotnisko |
Autobus, wspólne przejazdy, taksówka |
Pociąg |
|
Kategoria miejsca: Miejskie/ogólne/religijne (icon background color #7B9EB0) |
|||
Cmentarz |
Budynek miejski |
Biblioteka |
Pomnik |
Parking |
Szkoła (szkoła podstawowa, średnia, uczelnia wyższa) |
Modlitwa (chrześcijanin) |
|
Uwielbienie (hinduskie) |
Uwielbienie (islam) |
Wiedza (Jain) |
Oddawanie czci (żydów) |
Oddawanie czci (sikhów) |
Typowa firma |
||
Kategoria miejsca: Na zewnątrz (icon background color #4DB546) |
|||
Pływanie łodzią |
Kemping |
Park |
Stadion |
Zoo |
|||
Kategoria miejsca: alarmowe (kolor tła ikony #F88181) |
|||
Szpital |
Policja |