Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Значки мест

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

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

Поля

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

Поле	Класс 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 или .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,
    glyphSrc: new URL(String(place.svgIconMaskURI)),
});

const placeIconMarker = new AdvancedMarkerElement({
    position: place.location,
    title: place.displayName,
});
placeIconMarker.append(pinElement);
mapElement.append(placeIconMarker);index.ts

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,
    glyphSrc: new URL(String(place.svgIconMaskURI)),
});

const placeIconMarker = new AdvancedMarkerElement({
    position: place.location,
    title: place.displayName,
});
placeIconMarker.append(pinElement);
mapElement.append(placeIconMarker);index.js

Пример

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

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

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