Ikon tempat menunjukkan berbagai jenis tempat (misalnya kedai kopi, perpustakaan, dan museum). Anda dapat meminta URL untuk ikon dalam format PNG atau SVG, serta warna latar belakang ikon yang sesuai, dengan {i>Find Place<i}, Permintaan Place Details, Nearby Search, dan Text Search. Ikon dapat digunakan secara inline.
Setiap ikon ditentukan oleh dua kolom respons:
- URI dasar ikon berisi URL dasar untuk tidak berwarna
tanpa ekstensi jenis file. Anda harus menambahkan
.svg
atau.png
ke URI untuk meminta ikon. - Warna latar belakang ikon berisi kode warna HEX default untuk kategori tempat.
Contoh
Contoh berikut menunjukkan cara meminta URI ikon dan warna latar belakang untuk Places API (Baru) dan Places API. Perhatikan bahwa permintaan dan responsnya berbeda untuk kedua versi API.
Places API (Baru)
Contoh berikut menggunakan
Penelusuran Teks (Baru)
untuk mengembalikan nama tampilan tempat serta iconMaskBaseUri
dan
Kolom respons 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'
Responsnya berupa:
{ "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
Contoh berikut menunjukkan
Permintaan Find Place
yang mencakup icon_mask_base_uri
dan icon_background_color
bidang:
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
Contoh berikut menunjukkan cara kolom icon_mask_base_uri
dan icon_background_color
muncul dalam respons dari permintaan Find Place.
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>
Untuk menampilkan ikon, tambahkan ekstensi jenis file yang diinginkan (.png atau .svg) ke ikon yang ditampilkan URI, dan menggabungkan ikon dengan warna latar belakang yang ditampilkan. Misalnya, untuk menampilkan ikon .svg di laman web:
<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"/>
Permintaan warna ikon dan latar belakang tempat
Tabel berikut menampilkan semua ikon tempat yang tersedia menurut kategori. Secara default, ikon tempat ini ditampilkan dengan glyph hitam. Warna latar belakang ikon ditentukan berdasarkan kategori tempat.
Kategori tempat: Makanan dan minuman (warna latar belakang ikon #FF9E67) |
|||
---|---|---|---|
Bar, Klub malam |
Kafe |
Restoran, Toko Roti |
|
Kategori tempat: Retail (warna latar belakang ikon #4B96F3) |
|||
Buku, Pakaian, Elektronik, Perhiasan, Sepatu, Pusat Perbelanjaan/Mall |
Minimarket |
Toko Bahan Makanan, Supermarket |
Apotek |
Kategori tempat: Layanan (warna latar belakang ikon #909CE1) |
|||
ATM |
Bank |
SPBU |
Penginapan |
Kantor pos |
|||
Kategori tempat: Hiburan (warna latar belakang ikon #13B5C7) |
|||
Akuarium, Wisatawan |
Golf |
Bersejarah |
Film |
Museum |
Teater |
||
Kategori tempat: Transportasi (warna latar belakang ikon #10BDFF) |
|||
Bandara |
Bus, transportasi online, taksi |
Kereta/Transportasi Rel |
|
Kategori tempat: Kota/generik/agama (warna latar belakang ikon #7B9EB0) |
|||
Pemakaman |
Bangunan sipil |
Perpustakaan |
Monumen |
Parkir |
Sekolah (dasar, menengah, universitas) |
Ibadah (Kristen) |
|
Ibadah (Hindu) |
Ibadah (Islam) |
Ibadah (Jain) |
Ibadah (Yahudi) |
Ibadah (Sikh) |
Bisnis generik |
||
Kategori tempat: Luar Ruangan (warna latar belakang ikon #4DB546) |
|||
Naik perahu |
Berkemah |
Taman |
Stadion |
Kebun binatang |
|||
Kategori tempat: Darurat (warna latar belakang ikon #F88181) |
|||
Rumah Sakit |
Polisi |