地点图标

请选择平台： Android iOS JavaScript 网络服务
欧洲经济区 (EEA) 开发者

简介

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

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

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

示例

以下示例展示了如何为地点 API（新版）和地点 API（旧版）请求图标 URI 和背景颜色。请注意，这两个版本的 API 的请求和响应不同。

Places API（新）

以下示例使用文本搜索（新）返回地点的显示名称以及 iconMaskBaseUri 和 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'

响应格式如下：

{
  "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_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=API_KEY

以下示例展示了 icon_mask_base_uri 和 icon_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）
医院
医院 		警察局
警察局