地點圖示會指出不同類型的地點 (例如咖啡店、圖書館和博物館)。您可以使用 Find Place、Place Details、Nearby Search 和 Text Search 要求來取得 PNG 或 SVG 格式的圖示網址,以及對應的圖示背景顏色。圖示可內嵌使用。
以下顯示 Find Place 要求範例,包含 icon_mask_base_uri
和 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=YOUR_API_KEY
回應範例
以下範例顯示在 Find Place 要求回應中,icon_mask_base_uri
和 icon_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) |
|||
醫院 |
警察局 |