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