Значки мест

Выберите платформу: Android iOS JavaScript Веб-сервисы
Разработчики из Европейской экономической зоны (ЕЭЗ)

Введение

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

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

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

Пример

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

В примере ниже показан запрос 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=API_KEY

В следующем примере показаны поля icon_mask_base_uri и icon_background_color, полученные в ответе на запрос Find Place (устаревшая версия).

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>

Чтобы отобразить значок, добавьте к возвращенному 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)
Больница
Больница 		Полиция
Полиция