Biểu tượng địa điểm

Biểu tượng địa điểm biểu thị các loại địa điểm khác nhau (ví dụ: quán cà phê, thư viện và bảo tàng). Bạn có thể yêu cầu URL cho biểu tượng ở định dạng PNG hoặc SVG, cũng như màu nền biểu tượng tương ứng, với Tìm địa điểm, Yêu cầu Chi tiết địa điểm, Tìm kiếm lân cận và Tìm kiếm văn bản. Có thể sử dụng biểu tượng cùng dòng.

Mỗi biểu tượng được xác định bởi hai trường phản hồi:

• URI cơ sở biểu tượng chứa URL cơ sở cho một nội dung không có màu ngoại trừ đuôi tệp. Bạn phải thêm .svg hoặc .png đến URI để yêu cầu biểu tượng.
• Màu nền biểu tượng chứa mã màu HEX mặc định cho danh mục của địa điểm.

Ví dụ:

Các ví dụ sau đây minh hoạ cách yêu cầu URI biểu tượng và màu nền cho Places API (Mới) và Places API. Lưu ý rằng yêu cầu và phản hồi khác nhau cho hai phiên bản của API.

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

    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

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

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

Để hiển thị một biểu tượng, hãy thêm đuôi tệp mong muốn (.png hoặc .svg) vào biểu tượng được trả về URI và kết hợp biểu tượng với màu nền được trả về. Ví dụ: để hiển thị biểu tượng .svg trên trang 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"/>

Yêu cầu về biểu tượng địa điểm và màu nền

Các bảng sau hiển thị tất cả biểu tượng địa điểm có sẵn theo danh mục. Theo mặc định, các màn hình này có ký tự đen. Màu nền của biểu tượng do danh mục của địa điểm quyết định.

Danh mục địa điểm: Thực phẩm và đồ uống (màu nền biểu tượng #FF9E67)
Quán bar, Câu lạc bộ đêm	Quán cà phê	Nhà hàng, Tiệm bánh
Danh mục địa điểm: Bán lẻ (màu nền biểu tượng #4B96F3)
Sách, Quần áo, Đồ điện tử, Đồ trang sức, Giày dép, Trung tâm mua sắm/Trung tâm mua sắm	Cửa hàng tiện lợi	Cửa hàng tạp hoá, siêu thị	Hiệu thuốc
Danh mục địa điểm: Dịch vụ (màu nền biểu tượng #909CE1)
ATM	Ngân hàng	Xăng	Nơi lưu trú
Bưu điện
Danh mục địa điểm: Giải trí (màu nền biểu tượng #13B5C7)
Thuỷ cung, dành cho khách du lịch	Môn đánh gôn	Có tính lịch sử	Phim
Bảo tàng	Nhà hát
Danh mục địa điểm: Vận tải (màu nền biểu tượng #10BDFF)
Sân bay	Xe buýt, đi chung xe, taxi	Tàu/đường sắt
Danh mục địa điểm: Thành phố/chung/tôn giáo (màu nền biểu tượng #7B9EB0)
Nghĩa trang	Toà thị chính	Thư viện	Đài tưởng niệm
Bãi đỗ xe	Trường học (bậc tiểu học, trung học cơ sở, đại học)	Tôn giáo (Cơ Đốc giáo)
Tôn giáo (Hindu)	Tôn giáo (Đạo Hồi)	Tôn giáo (Jain)	Tôn giáo (Do Thái giáo)
Tôn giáo (Sikh)	Hoạt động kinh doanh nói chung
Danh mục địa điểm: Ngoài trời (màu nền biểu tượng #4DB546)
Đi thuyền	Cắm trại	Công viên	Sân vận động
Vườn bách thú
Danh mục địa điểm: Khẩn cấp (màu nền biểu tượng #F88181)
Bệnh viện	Cảnh sát