Значки мест

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

Поля

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

• 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.

// 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

// 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)
Больница	Полиция