Ikon Tempat

Pilih platform: Android iOS JavaScript Layanan Web

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
Bar,
Klub malam
Kafe
Kafe
Restoran
Restoran, Toko Roti
Kategori tempat: Retail
(warna latar belakang ikon #4B96F3)
Toko Buku
Buku, Pakaian, Elektronik, Perhiasan, Sepatu,
Pusat Perbelanjaan/Mall
Minimarket
Minimarket
Toko bahan makanan
Toko Bahan Makanan, Supermarket
Apotek
Apotek
Kategori tempat: Layanan
(warna latar belakang ikon #909CE1)
ATM
ATM
Bank
Bank
SPBU
SPBU
Penginapan
Penginapan
Kantor pos
Kantor pos
Kategori tempat: Hiburan
(warna latar belakang ikon #13B5C7)
Akuarium, Wisatawan
Akuarium, Wisatawan
Golf
Golf
Bersejarah
Bersejarah
Film
Film
Museum
Museum
Teater
Teater
Kategori tempat: Transportasi
(warna latar belakang ikon #10BDFF)
Bandara
Bandara
Bus
Bus, transportasi online, taksi
Kereta/Transportasi Rel
Kereta/Transportasi Rel
Kategori tempat: Kota/generik/agama
(warna latar belakang ikon #7B9EB0)
Pemakaman
Pemakaman
Bangunan sipil
Bangunan sipil
Perpustakaan
Perpustakaan
Monumen
Monumen
Parkir
Parkir
Sekolah (utama, menengah, universitas)
Sekolah (dasar, menengah, universitas)
Ibadah (Kristen)
Ibadah (Kristen)
Ibadah (Hindu)
Ibadah (Hindu)
Ibadah (Islam)
Ibadah (Islam)
Ibadah (Jain)
Ibadah (Jain)
Ibadah (Yahudi)
Ibadah (Yahudi)
Ibadah (Sikh)
Ibadah (Sikh)
Bisnis generik
Bisnis generik
Kategori tempat: Luar Ruangan
(warna latar belakang ikon #4DB546)
Naik perahu
Naik perahu
Berkemah
Berkemah
Taman
Taman
Stadion
Stadion
Kebun binatang
Kebun binatang
Kategori tempat: Darurat
(warna latar belakang ikon #F88181)
Rumah sakit
Rumah Sakit
Polisi
Polisi