Значки мест

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

Введение

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

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

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

Пример

В следующих примерах показано, как запросить URI значка и цвет фона для API Places (новый) и API Places (устаревший). Обратите внимание, что запрос и ответы различаются для двух версий API.

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

API мест (устаревший)

В следующем примере показан запрос Find Place (Legacy) , который включает поля 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 (Legacy).

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