Ikon Tempat

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.

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'

{
  "places": [
    {
      "iconMaskBaseUri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet",
      "iconBackgroundColor": "#FF9E67",
      "displayName": {
        "text": "SKÖG Haus Coffee & Tea",
        "languageCode": "en"
      }
    }
  ]
}

    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

    {
      "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"
    }
          

    <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