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 permintaan Find Place, 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 ikon tidak berwarna, tanpa ekstensi jenis file. Anda harus menambahkan
.svg
atau.png
ke URI untuk meminta ikon. - Warna latar belakang ikon berisi kode warna heksadesimal default untuk kategori tempat tersebut.
Contoh
Contoh berikut menunjukkan cara meminta URI ikon dan warna latar belakang untuk Places API (Baru) dan Places API. Perhatikan bahwa permintaan dan respons untuk kedua versi API berbeda.
Places API (Baru)
Contoh berikut menggunakan
Text Search (Baru)
untuk menampilkan nama tampilan tempat serta kolom respons iconMaskBaseUri
dan
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'
Respons akan dalam bentuk:
{ "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 menyertakan kolom icon_mask_base_uri
dan
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
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 URI ikon yang ditampilkan, lalu gabungkan ikon dengan warna latar belakang yang ditampilkan. Misalnya, untuk menampilkan ikon .svg di halaman 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/Kereta |
|
Kategori tempat: Kota/generik/agama (warna latar belakang ikon #7B9EB0) |
|||
Pemakaman |
Bangunan sipil |
Koleksi |
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 kapal |
Berkemah |
Taman |
Stadion |
Kebun binatang |
|||
Kategori tempat: Darurat (warna latar belakang ikon #F88181) |
|||
Rumah Sakit |
Polisi |