Yer simgeleri, çeşitli yer türlerini gösterir (örneğin, kafeler, kütüphaneler, müzeler). Yer Bulma, Yer Ayrıntıları, Yakında Arama ve Metin Arama istekleriyle birlikte PNG veya SVG biçimindeki simgeler için URL'lerin yanı sıra karşılık gelen simge arka plan rengini isteyebilirsiniz. Simgeler satır içinde kullanılabilir.
Her simge, iki yanıt alanıyla tanımlanır:
- Simge temel URI'sı, renkli olmayan bir simgenin temel URL'sini dosya türü uzantısı hariç tutarak içerir. Simgeyi istemek için URI'ye
.svg
veya.png
eklemeniz gerekir. - Simge arka plan rengi, yer kategorisi için varsayılan HEX renk kodunu içerir.
Örnek
Aşağıdaki örneklerde, Yerler API'si (Yeni) ve Places API için nasıl simge URI'si ve arka plan rengi isteneceği gösterilmektedir. API'nin iki sürümü için isteğin ve yanıtların farklı olduğuna dikkat edin.
Places API (Yeni)
Aşağıdaki örnekte, bir yerin görünen adının yanı sıra iconMaskBaseUri
ve iconBackgroundColor
yanıt alanlarını döndürmek için Metin Arama (Yeni) kullanılmaktadır:
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'
Yanıt şu biçimdedir:
{ "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
Aşağıdaki örnekte, icon_mask_base_uri
ve icon_background_color
alanlarını içeren bir Yer Bulma isteği gösterilmektedir:
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
Aşağıdaki örnekte icon_mask_base_uri
ve icon_background_color
alanlarının Yer Bulma isteğine verilen yanıtta nasıl göründüğü gösterilmektedir.
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>
Bir simge görüntülemek için, istenen dosya türü uzantısını (.png veya .svg) döndürülen simge URI'sına ekleyin ve döndürülen arka plan rengiyle simgeyi birleştirin. Örneğin, bir web sayfasında .svg simgesini görüntülemek için:
<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"/>
Yer simgesi ve arka plan rengi istekleri
Aşağıdaki tablolarda, kullanılabilir tüm yer simgeleri kategorilere göre gösterilmektedir. Bu resimler varsayılan olarak siyah bir karakterle gösterilir. Simge arka plan rengi, yerin kategorisine göre belirlenir.
Yer kategorisi: Yiyecek ve içecek (simge arka plan rengi #FF9E67) |
|||
---|---|---|---|
Bar, Gece kulübü |
Kafe |
Restoran, Fırın |
|
Yer kategorisi: Perakende (simge arka plan rengi #4B96F3) |
|||
Kitaplar, Giyim, Elektronik, Takılar, Ayakkabılar, Alışveriş merkezi/Alışveriş merkezi |
Market |
Bakkal, Süpermarket |
Eczane |
Yer kategorisi: Hizmetler (simge arka plan rengi #909CE1) |
|||
ATM |
Banka |
Benzin |
Konaklama |
Postane |
|||
Yer kategorisi: Eğlence (simge arka plan rengi #13B5C7) |
|||
Akvaryum, Turist |
Golf |
Geçmiş |
Film |
Müze |
Tiyatro |
||
Yer kategorisi: Ulaşım (simge arka plan rengi #10BDFF) |
|||
Havaalanı |
Otobüs, araç paylaşma, taksi |
Tren/Demiryolu |
|
Yer kategorisi: Belediye/genel/dini (simge arka plan rengi #7B9EB0) |
|||
Mezarlık |
Belediye binası |
Kitaplık |
Anıt |
Park yeri |
Okul (ilkokul, ortaokul, üniversite) |
İbadet (Hristiyan) |
|
İbadet (Hindu) |
İbadet (İslam) |
İbadet (Jain) |
İbadet (Yahudi) |
İbadet (Sikh) |
Genel işletme |
||
Yer kategorisi: Dış mekan (simge arka plan rengi #4DB546) |
|||
Tekne Gezisi |
Kampçılık |
Park et |
Stadyum |
Hayvanat Bahçesi |
|||
Yer kategorisi: Acil durum (simge arka plan rengi #F88181) |
|||
Hastane |
Polis |