地點圖示

地點圖示會指出不同類型的地點 (例如咖啡店、圖書館和博物館)。您可以透過 Find PlacePlace DetailsNearby SearchText Search 要求來要求 PNG 或 SVG 格式的圖示網址,以及對應的圖示背景顏色。圖示可內嵌使用。

以下範例顯示 Find Place 要求範例,包含 icon_mask_base_uriicon_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=YOUR_API_KEY
    

回應範例

以下範例顯示在 Find Place 要求回應中,icon_mask_base_uriicon_background_color 欄位的顯示方式。如要使用網址,請附加所需檔案類型副檔名 (.png 或 .svg)。

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>
          

欄位

每個地點圖示都包含以下三個欄位:

  • icon 會傳回 71 像素 x 71 像素 PNG 彩色圖示的網址。
  • icon_mask_base_uri 會傳回非彩色圖示的基準網址,刪除檔案類型副檔名 (附加 .svg 或 .png)。
  • icon_background_color 會傳回地點類別的預設十六進位顏色代碼。

地點圖示和背景顏色要求

下表依類別列出所有可用的地點圖示。根據預設,這些圖示會以黑色字符顯示。icon_background_color 取決於地點類別。

地點類別:餐飲
(圖示背景顏色 #FF9E67)
酒吧
酒吧、
夜店
咖啡館
咖啡館
餐廳
餐廳、烘焙坊
地點類別:零售
(圖示背景顏色 #4B96F3)
書店
書籍、服飾、電子產品、珠寶、鞋子、
購物中心/商場
便利商店
便利商店
雜貨店
雜貨店、超市
藥局
藥局
地點類別:服務
(圖示背景顏色 #909CE1)
提款機
提款機
銀行
銀行
加油站
加油站
住宿地點
住宿地點
郵局
郵局
地點類別:娛樂
(圖示背景顏色 #13B5C7)
水族館、觀光旅遊
水族館、觀光旅遊
高爾夫
高爾夫
歷史古蹟
歷史古蹟
電影
電影
博物館
博物館
劇場
劇場
地點類別:交通運輸
(圖示背景顏色 #10BDFF)
機場
機場
公車
公車、代僱駕駛服務、計程車
火車/鐵路
火車/鐵路
地點類別:市政/一般/宗教
(圖示背景顏色 #7B9EB0)
墓園
墓園
市政建築
市政建築
圖書館
圖書館
紀念碑
紀念碑
停車場
停車場
學校 (小學、中學、大專院校)
學校 (小學、中學、大專院校)
宗教 (佛教)
宗教 (佛教)
宗教 (基督教)
宗教 (基督教)
宗教 (印度教)
宗教 (印度教)
宗教 (伊斯蘭教)
宗教 (伊斯蘭教)
宗教 (耆那教)
宗教 (耆那教)
宗教 (猶太教)
宗教 (猶太教)
宗教 (錫克教)
宗教 (錫克教)
一般業務
一般業務
地點類別:戶外
(圖示背景顏色 #4DB546)
乘船
乘船
露營
露營
公園
公園
體育場館
體育場館
動物園
動物園
地點類別:緊急狀況
(圖示背景顏色 #F88181)
醫院
醫院
警察局
警察局