Значки мест

Введение

Значки мест служат для обозначения мест разных типов (например, кофеен, библиотек и музеев). Получать URL-адреса значков в формате PNG или SVG, а также цвет их фона можно с помощью запросов Find Place, информация о местах, поиск поблизости и текстовый поиск. Значки можно встраивать в другие объекты.

Каждый значок определяется двумя полями ответа:

• Базовый URI значка содержит базовый URL значка без цвета без указания расширения типа файла. Чтобы запросить значок, добавьте к URI .svg или .png.
• Цвет фона значка содержит шестнадцатеричный код цвета по умолчанию для категории места.

Пример

В примерах ниже показано, как запросить URI значка и цвет фона для Places API (нового) и Places API (устаревшего). Обратите внимание, что запросы и ответы для двух версий 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>
          

Чтобы отобразить значок, добавьте к возвращенному URI значка расширение типа файла (.png или .svg) и объедините значок с возвращенным цветом фона. Например, чтобы показать на веб-странице значок в формате 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)
Банкомат	Банк	АЗС	Гостиница
Почтовое отделение
Категория места: развлечения (цвет фона #13B5C7)
Аквариум, туризм	Гольф	Историческое место	Кинотеатр
Музей	Театр
Категория места: транспорт (цвет фона #10BDFF)
Аэропорт	Автобус, такси, совместные поездки	Рельсовый транспорт
Категория места: общественные, религиозные и прочие места (цвет фона #7B9EB0)
Кладбище	Общественное здание	Библиотека	Памятник
Парковка	Образовательное учреждение (начальное, среднее, высшее)	Место поклонения (христианство)
Место поклонения (индуизм)	Место поклонения (ислам)	Место поклонения (джайнизм)	Место поклонения (иудаизм)
Место поклонения (сикхизм)	Прочие места
Категория места: активный отдых (цвет фона #4DB546)
Водные прогулки	Кемпинг	Парк	Стадион
Зоопарк
Категория места: экстренная помощь (цвет фона #F88181)
Больница	Полиция