رموز الأماكن

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

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

الحقول

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

الحقل	فئة المكان	خدمة "الأماكن"
الرمز	---	icon
لون خلفية الرمز	iconBackgroundColor	icon_background_color
عنوان URL لقناع الرمز	svgIconMaskURI	icon_mask_base_uri

• تعرِض السمة icon عنوان URL لرمز PNG ملون أبعاده 71 بكسل × 71 بكسل (لخدمة "الأماكن" فقط).
• يعرض الحقلان iconBackgroundColor وicon_background_color الرمز السداسي العشري للون التلقائي لفئة رمز المكان.
• يعرض icon_mask_base_uri (Places Service) عنوان URL الأساسي لرمز غير ملون، بدون امتداد نوع الملف (أضِف .svg أو .png).
• svgIconMaskURI (Place Class) يعرض عنوان 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,
    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)
مستشفى	الشرطة