Значки мест

Выберите платформу: Android iOS JavaScript Веб-сервисы

Значки мест обозначают разные типы мест (например, кофейни, библиотеки, музеи). Запрашивать значки и цвета их фона можно с помощью класс Place или сервис Places.

Поля

Для работы со значками мест используются следующие поля:

Поле	Класс Place	Сервис Places
Icon (Значок)	---	icon
Icon background color (Цвет фона значка)	iconBackgroundColor	icon_background_color
Icon mask URI (URI маски значка)	svgIconMaskURI	icon_mask_base_uri

• icon возвращает URL цветного значка в формате PNG размером 71 x 71 пкс (только сервис Places).
• iconBackgroundColor и icon_background_color возвращают шестнадцатеричный код цвета по умолчанию для категории значков мест.
• icon_mask_base_uri (сервис Places) возвращает базовый URL значка без цвета без указания расширения (добавьте .svg or .png).
• svgIconMaskURI (класс Place) возвращает базовый URL для значка без цвета в формате SVG.

Как применить значок места и цвет к маркеру

С помощью запроса Place Details вы можете запросить значок места и цвет фона и использовать их для маркеров. Ниже показан код, который позволяет создать маркер, используя данные о месте, передавая place.iconBackgroundColor в функцию PinElement.background, а place.svgIconMaskURI – в PinElement.glyph. Чтобы правильно разместить маркер, используйте place.location. В этом примере в качестве названия маркера используется place.displayName.

TypeScript

// A marker customized using a place icon and color, name, and geometry.
const place = new Place({
    id: 'ChIJN5Nz71W3j4ARhx5bwpTQEGg',
});

// Call fetchFields, passing the desired data fields.
await place.fetchFields({ fields: ['location', 'displayName', 'svgIconMaskURI', 'iconBackgroundColor'] });

const pinElement = new PinElement({
    background: place.iconBackgroundColor,
    glyph: new URL(String(place.svgIconMaskURI)),
});

const placeIconMarkerView = new AdvancedMarkerElement({
    map,
    position: place.location,
    content: pinElement.element,
    title: place.displayName,
});
index.ts

Примечание. Ознакомьтесь с руководством по использованию TypeScript в Google Картах.

JavaScript

// A marker customized using a place icon and color, name, and geometry.
const place = new Place({
  id: "ChIJN5Nz71W3j4ARhx5bwpTQEGg",
});

// Call fetchFields, passing the desired data fields.
await place.fetchFields({
  fields: [
    "location",
    "displayName",
    "svgIconMaskURI",
    "iconBackgroundColor",
  ],
});

const pinElement = new PinElement({
  background: place.iconBackgroundColor,
  glyph: new URL(String(place.svgIconMaskURI)),
});
const placeIconMarkerView = new AdvancedMarkerElement({
  map,
  position: place.location,
  content: pinElement.element,
  title: place.displayName,
});
index.js

Пример

Как запросить значки мест и их фоновый цвет

В таблицах ниже показаны все доступные значки мест с разбивкой по категориям. По умолчанию они представляют собой черный глиф. Цвет фона зависит от категории места.

Категория места: еда и напитки (цвет фона #FF9E67)
Бар, ночной клуб	Кафе	Ресторан, пекарня
Категория места: розничная торговля (цвет фона #4B96F3)
Книги, одежда, электроника, ювелирные изделия, обувь, торговые центры	Мини-маркет	Продуктовый магазин, супермаркет	Аптека
Категория места: услуги (цвет фона #909CE1)
Банкомат	Банк	АЗС	Гостиница
Почтовое отделение
Категория места: развлечения (цвет фона #13B5C7)
Аквариум, туризм	Гольф	Историческое место	Кинотеатр
Музей	Театр
Категория места: транспорт (цвет фона #10BDFF)
Аэропорт	Автобус, такси, совместные поездки	Рельсовый транспорт
Категория места: общественные, религиозные и прочие места (цвет фона #7B9EB0)
Кладбище	Общественное здание	Библиотека	Памятник
Парковка	Образовательное учреждение (начальное, среднее, высшее)	Место поклонения (христианство)
Место поклонения (индуизм)	Место поклонения (ислам)	Место поклонения (джайнизм)	Место поклонения (иудаизм)
Место поклонения (сикхизм)	Прочие места
Категория места: активный отдых (цвет фона #4DB546)
Водные прогулки	Кемпинг	Парк	Стадион
Зоопарк
Категория места: экстренная помощь (цвет фона #F88181)
Больница	Полиция