نمادهای مکان

پلاتفرم را انتخاب کنید: Android iOS JavaScript سرویس وب

نمادهای مکان انواع مختلف مکان‌ها را نشان می‌دهند (برای مثال، قهوه‌سرا، کتابخانه، و موزه). می‌توانید نمادها و رنگ پس‌زمینه آن‌ها را بااستفاده از کلاس مکان درخواست کنید.

فیلدها

از فیلدهای زیر برای کار با نمادهای مکان استفاده کنید:

فیلد	کلاس مکان	سرویس مکان‌ها
نماد	---	icon
رنگ پس‌زمینه نماد	iconBackgroundColor	icon_background_color
URI ماسک نماد	svgIconMaskURI	icon_mask_base_uri

• icon نشانی وب را برای نماد PNG رنگی ۷۱ پیکسل در ۷۱ پیکسل برمی‌گرداند (فقط سرویس مکان‌ها).
• iconBackgroundColor و icon_background_color کد رنگ HEX پیش‌فرض را برای دسته نماد مکان برمی‌گردانند.
• icon_mask_base_uri (Places Service) نشانی وب پایه را برای نماد بدون رنگ، منهای پسوند نوع فایل (.svg یا .png را اضافه کنید) برمی‌گرداند.
• ‫svgIconMaskURI (Place Class) نشانی وب پایه را برای نماد SVG بدون رنگ برمی‌گرداند.

اعمال کردن نماد و رنگ مکان به نشانگر

با «جزئیات جا»، می‌توانید نماد جا و رنگ پس‌زمینه درخواست کنید و آن را روی نشانگرها اعمال کنید. مثال زیر کدی را نشان می‌دهد که برای ایجاد نشانگر بااستفاده از داده‌های مکان، 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

توجه: راهنمای استفاده از TypeScript و Google Maps را بخوانید.

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)
بیمارستان	پلیس