סמלי מקומות

בחירת פלטפורמה: Android iOS JavaScript שירות אינטרנט

סמלי המקומות מציינים את סוגי המקומות השונים (לדוגמה בתי קפה, ספריות מוזיאונים). אפשר לבקש סמלים ואת צבעי הרקע שלהם באמצעות Place Class, או שירות מקומות.

שדות

אפשר להשתמש בשדות הבאים כדי לעבוד עם סמלים של מקומות:

שדה	כיתה במקום	שירות מקומות
סמל	---	icon
צבע רקע סמל	iconBackgroundColor	icon_background_color
URI של מסכת סמל	svgIconMaskURI	icon_mask_base_uri

• icon מחזירה את כתובת ה-URL של סמל PNG צבעוני בגודל 71px x 71px (שירות מקומות) בלבד).
• iconBackgroundColor ו-icon_background_color יחזירו את קוד הצבע HEX שמוגדר כברירת מחדל לקטגוריה של סמל המקום.
• icon_mask_base_uri (שירות מקומות) מחזיר את כתובת ה-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)
אקווריום, תיירים	גולף	היסטורי	Movie (סרט)
מוזיאון	תיאטרון
קטגוריית מקום: תחבורה (סמל רקע #10BDFF)
נמל תעופה	אוטובוס, נסיעה משותפת, מונית	רכבת
קטגוריית מקום: עירוני/גנרי/דתי (צבע רקע #7B9EB0)
בית קברות	מבנה ציבורי	לספרייה	אנדרטה
חנייה	בית ספר (יסודי, חטיבת ביניים, אוניברסיטה)	תפילה (נוצרית)
תפילה (הינדי)	פולחן (איסלאם)	תפילה (ג'יין)	פולחן (יהודי)
תפילה (סיח)	עסק כללי
קטגוריית מקום: בחוץ (סמל רקע #4DB546)
שייט	מחנאות	פארק	אצטדיון
גן חיות
קטגוריית מקום: מצב חירום (סמל רקע בצבע #F88181)
בית חולים	משטרה