地点图标

请选择平台: Android iOS JavaScript 网络服务

地点图标表示各种类型的地点(例如咖啡馆、图书馆和博物馆)。您可以通过“查找地点”“地点详情”“附近搜索”和“文本搜索”请求来请求 PNG 或 SVG 格式图标的网址以及相应的图标背景颜色。图标可内嵌使用。

每个图标均由两个响应字段定义:

  • 图标基准 URI 包含非彩色图标的基础网址,去掉文件类型扩展名。您必须将 .svg.png 附加到 URI 才能请求图标。
  • 图标背景颜色包含地点类别的默认十六进制颜色代码。

示例

以下示例展示了如何为 Places API(新)和 Places API 请求图标 URI 和背景颜色。请注意,两个版本的 API 的请求和响应有所不同。

Places API(新)

以下示例使用文本搜索(新)返回地点的显示名称以及 iconMaskBaseUriiconBackgroundColor 响应字段:

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

Places API

以下示例展示了包含 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=API_KEY

以下示例展示了 icon_mask_base_uriicon_background_color 字段在“查找地点”请求响应中的显示方式。

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>
          

如需显示图标,请将所需的文件类型扩展名(.png 或 .svg)附加到返回的图标 URI,然后将图标与返回的背景颜色组合在一起。例如,如需在网页上显示 .svg 图标,请使用以下代码:

<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"/>

地点图标和背景颜色请求

下表按类别显示了所有可用的地点图标。默认情况下,这些图标以黑色字形显示。图标背景颜色取决于地点的类别。

地点类别:食品和饮料
(图标背景颜色 #FF9E67)
条形图
酒吧、夜总会
咖啡馆
咖啡馆
餐馆
餐馆、糕点店
地点类别:零售
(图标背景颜色 #4B96F3)
书店
图书、服装、电子产品、珠宝、鞋类、购物中心/商场
便利店
便利店
杂货店
杂货店、超市
药店
药店
地点类别:服务
(图标背景颜色 #909CE1)
ATM
ATM 机
银行
银行
加油站
汽油
住宿
住宿
邮局
邮局
地点类别:娱乐
(图标背景颜色 #13B5C7)
水族馆、旅游
水族馆、旅游
高尔夫
高尔夫
历史古迹
历史古迹
电影院
电影
博物馆
博物馆
剧院
剧院
地点类别:交通
(图标背景颜色 #10BDFF)
机场
机场
巴士
公交车、拼车、出租车
火车/轨道交通
火车/轨道交通
地点类别:市政/一般/宗教
(图标背景颜色 #7B9EB0)
墓地
墓地
市政建筑
市政建筑
图书馆
媒体库
纪念碑
纪念碑
停车
停车场
学校(小学、中学、大学)
学校(小学、中学、大学)
宗教场所(基督教)
宗教场所(基督教)
宗教场所(印度教)
宗教场所(印度教)
宗教场所(伊斯兰教)
宗教场所(伊斯兰教)
宗教场所(耆那教)
宗教场所(耆那教)
宗教场所(犹太教)
宗教场所(犹太教)
宗教场所(锡克教)
宗教场所(锡克教)
一般业务
一般业务
地点类别:户外
(图标背景颜色 #4DB546)
乘船
乘船
野营
野营
公园
公园
体育馆
体育馆
动物园
动物园
地点类别:紧急状况
(图标背景颜色 #F88181)
医院
医院
警察局
警察局