حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

رموز الأماكن

اختيار النظام الأساسي: Android iOS JavaScript خدمة الويب

تشير رموز الأماكن إلى الأنواع المختلفة من الأماكن (مثل المقاهي والمكتبات والمتاحف). يمكنك طلب الرموز وألوان خلفيتها باستخدام فئة المكان.

الحقول

استخدِم الحقول التالية للتعامل مع رموز الأماكن:

الحقل	فئة المكان	خدمة الأماكن
رمز	---	`icon`
لون خلفية الرمز	`iconBackgroundColor`	`icon_background_color`
معرّف الموارد المنتظم (URI) لقناع الرمز	`svgIconMaskURI`	`icon_mask_base_uri`

تعرض السمة icon عنوان URL لرمز PNG ملوّن بحجم 71 × 71 بكسل (خدمة "الأماكن" فقط).
iconBackgroundColor وicon_background_color يعرضان رمز اللون الست عشري التلقائي لفئة رمز المكان.
تعرض السمة icon_mask_base_uri (خدمة الأماكن) الجزء الأساسي من عنوان URL لرمز غير ملوّن، بدون امتداد نوع الملف (يجب إلحاق .svg أو .png).
تعرض السمة svgIconMaskURI (فئة المكان) الجزء الأساسي من عنوان URL لرمز 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

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)
ماكينة صرّاف آلي (ATM)	مصرف	الغاز	أماكن إقامة
مكتب بريد
فئة المكان: ترفيه (لون خلفية الرمز ‎ #13B5C7)
حديقة أسماك، سياحة	الغولف	تاريخي	فيلم
متحف	المسرح
فئة المكان: وسائل النقل (لون خلفية الرمز ‎ #10BDFF)
مطار	حافلة، مشاركة الرحلات، سيارة أجرة	قطار/سكة حديدية
فئة المكان: بلدية/عام/ديني (لون خلفية الرمز ‎ #7B9EB0)
مقبرة	مبنى مدني	المكتبة	نصب تذكاري
موقف سيارات	المدرسة (الابتدائية أو الثانوية أو الجامعة)	أغاني عبادة (مسيحية)
أماكن عبادة (هندوسية)	العبادة (الإسلام)	أماكن عبادة (الجاينية)	عبادة (يهودية)
مكان عبادة (سيخي)	نشاط تجاري عام
فئة المكان: في الهواء الطلق (لون خلفية الرمز ‎ #4DB546)
ركوب القوارب	التخييم	حديقة	Stadium
حديقة حيوانات
فئة المكان: طوارئ (لون خلفية الرمز ‎ #F88181)
مستشفى	الشرطة