סמלי מקומות

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

שדות

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

• הפונקציה icon מחזירה את כתובת ה-URL של סמל PNG צבעוני בגודל 71px x 71px (רק בשירות Places).
• הפונקציות iconBackgroundColor ו-icon_background_color מחזירות את קוד הצבע הקסדצימלי שמוגדר כברירת מחדל לקטגוריה של סמל המקום.
• icon_mask_base_uri (שירות Places) מחזירה את כתובת ה-URL הבסיסית של סמל לא צבעוני, ללא סיומת סוג הקובץ (צריך לצרף את .svg או .png).
• svgIconMaskURI (Place Class) מחזירה את כתובת ה-URL הבסיסית של סמל SVG לא צבעוני.

החלת סמל וצבע של מקום על סמן

בעזרת פרטי המיקום תוכלו לבקש סמל של מקום וצבע רקע שתוכלו להחיל על סמנים. בדוגמה הבאה מוצג קוד ליצירת סמן באמצעות נתוני מקום, על ידי העברת הערך place.iconBackgroundColor לאפשרות PinElement.background והערך place.svgIconMaskURI ל-PinElement.glyph. משתמשים ב-place.location כדי למקם את הסמן במיקום הנכון. בדוגמה הזו, ה-place.displayName מוצג גם בכותרת של הסמן.

// 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

// 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)
בית קברות	מבנה ציבורי	Library	אנדרטה
חניה	בית ספר (יסודי, תיכון, אוניברסיטה)	טקסים רוחניים (נוצריים)
טקסים רוחניים (הינדי)	פולחן (איסלאם)	טקסים רוחניים (ג'ייני)	טקסים רוחניים (יהדות)
טקסים רוחניים (סיקי)	עסק כללי
קטגוריית המקום: חוץ (צבע הרקע של הסמל: #4DB546)
שייט בסירה	קמפינג	פארק	אצטדיון
גן חיות
קטגוריית מקום: חירום (צבע הרקע של הסמל הוא #F88181)
בית חולים	משטרה