Ikony miejsc wskazują różne typy miejsc (np. kawiarnie, biblioteki i muzea). Możesz poprosić o adresy URL ikon w formacie PNG lub SVG, oraz koloru tła tej ikony, a przy pomocy funkcji Znajdź miejsce Żądania dotyczące szczegółów miejsca, wyszukiwania w pobliżu i wyszukiwania tekstowego. Ikony można używać w tekście.
Każda ikona jest definiowana przez 2 pola odpowiedzi:
- Podstawowy identyfikator URI ikony zawiera podstawowy adres URL reklamy bez koloru.
ikonę, bez rozszerzenia typu pliku. Musisz dołączyć atrybut
.svg
lub.png
do identyfikatora URI, aby poprosić o ikonę. - Kolor tła ikony zawiera domyślny szesnastkowy kod koloru dla: kategorię miejsca.
Przykład
W przykładach poniżej pokazujemy, jak zażądać identyfikatora URI ikony i koloru tła Places API (nowość) i Places API. Zwróć uwagę, że prośba i odpowiedzi są różne dla obu wersji interfejsu API.
Places API (nowość)
W poniższym przykładzie użyto
Wyszukiwanie tekstowe (nowość)
zwraca wyświetlaną nazwę miejsca, a także iconMaskBaseUri
oraz
Pola odpowiedzi 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 pokazuje
Prośba o znajdowanie miejsca
w tym icon_mask_base_uri
i icon_background_color
pola:
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
W poniższym przykładzie pokazano, jak funkcje icon_mask_base_uri
i
W odpowiedzi z funkcji Znajdź miejsce pojawiają się pola icon_background_color
użytkownika.
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 odpowiednie rozszerzenie typu pliku (.png lub .svg) do zwróconej ikony. Identyfikator 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 dotyczące ikony miejsc i koloru tła
W tabelach poniżej znajdziesz wszystkie dostępne ikony miejsc pogrupowane według kategorii. Według domyślnie wyświetlają się z czarnym glifem. Kolor tła ikony. zależy od 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/hala |
, Sklep wielobranżowy |
, Sklep spożywczy, supermarket |
, Apteka |
Kategoria miejsca: usługi (kolor tła ikony #909CE1) |
|||
, Bankomat |
, Bank |
, Stacje paliw |
, Zakwaterowanie |
, Urząd pocztowy |
|||
Kategoria miejsca: Rozrywka (kolor tła ikony #13B5C7) |
|||
, Akwarium, turystyka |
, Golf |
, Historyczne |
, Film |
, Muzeum |
, Teatr |
||
Kategoria miejsca: Transport (kolor tła ikony #10BDFF) |
|||
, Lotnisko |
, Autobus, wspólne przejazdy, taksówka |
, Pociąg |
|
Kategoria miejsca: miejskie/ogólne/religijne (kolor tła ikony #7B9EB0) |
|||
, Cmentarz |
, Budynek miejski |
, Biblioteka |
, Pomnik |
, Parkingi |
, Szkoła (podstawowa, ponadpodstawowa, uniwersytet) |
, Kultura (chrześcijańska) |
|
, Kultura (hinduizm) |
, Kultura (islam) |
, Kult (Jain) |
, Kultura (żydowski) |
, Kult (Sikh) |
, Ogólna firma |
||
Kategoria miejsca: Odkryte (kolor tła ikony #4DB546) |
|||
, Łodzią |
, Kemping |
, Park |
, Stadion |
, Zoo |
|||
Kategoria miejsca: Alarmowe (kolor tła ikony #F88181) |
|||
, Szpital |
, Policja |