סמלי מקומות

בחירת פלטפורמה: Android iOS JavaScript Web Service

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

כל סמל מוגדר על ידי שני שדות תגובה:

  • מזהה ה-URI הבסיסי של הסמל מכיל את כתובת ה-URL הבסיסית של סמל לא צבעוני, בניכוי סיומת סוג הקובץ. כדי לבקש את הסמל, צריך לצרף את הערך .svg או .png ל-URI.
  • צבע הרקע של הסמל מכיל את קוד הצבע הקסדצימלי שמוגדר כברירת מחדל לקטגוריה של המקום.

דוגמה

בדוגמאות הבאות מוסבר איך לבקש URI של סמל וצבע רקע ל-Places API (חדש) ול-Places API. שימו לב שהבקשה והתשובות שונות בשתי הגרסאות של ה-API.

בדוגמה הבאה נעשה שימוש ב-Text Search (New) כדי להציג את השם המוצג של מקום מסוים, וגם את השדות iconMaskBaseUri ו-iconBackgroundColor בתשובה:

curl -X POST -d '{
  "textQuery" : "skog haus",
  "maxResultCount" : 1
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.iconMaskBaseUri,places.iconBackgroundColor' \
'https://places.googleapis.com/v1/places:searchText'

התגובה תהיה בפורמט:

{
  "places": [
    {
      "iconMaskBaseUri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet",
      "iconBackgroundColor": "#FF9E67",
      "displayName": {
        "text": "SKÖG Haus Coffee & Tea",
        "languageCode": "en"
      }
    }
  ]
}

בדוגמה הבאה מוצגת בקשה לחיפוש מקום שכוללת את השדות icon_mask_base_uri ו-icon_background_color:

    https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=skog%20haus&inputtype=textquery&fields=name,icon_mask_base_uri,icon_background_color&key=API_KEY

בדוגמה הבאה אפשר לראות איך השדות icon_mask_base_uri ו-icon_background_color מופיעים בתגובה לבקשת חיפוש מקום.

JSONXML
    {
      "candidates" : [
          {
            "icon_background_color" : "#FF9E67",
            "icon_mask_base_uri" : "https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet",
            "name" : "SKÖG Haus Coffee",
          }
      ],
      "status" : "OK"
    }
          
    <FindPlaceFromTextResponse>
      <candidates>
        <name>SKÖG Haus Coffee</name>
        <icon_background_color>#FF9E67</icon_background_color>
        <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet</icon_mask_base_uri>
      </candidates>
      <status>OK</status>
    </FindPlaceFromTextResponse>
          

כדי להציג סמל, צריך לצרף את הסיומת של סוג הקובץ (‎.png או ‎ .svg) הרצויה למזהה ה-URI של הסמל המוחזר, ולשלב את הסמל עם צבע הרקע המוחזר. לדוגמה, כדי להציג את הסמל ‎ .svg בדף אינטרנט:

<style>
  .icons-food-drink {
    background-color: #FF9E67;
    width: 88px;
    height: 88px;
    padding: 5px;
  }
</style>

<img src="https://maps.gstatic.com/mapfiles/place_api/icons/v2/cafe_pinlet.svg" alt="Cafe" class="icons-food-drink"/>

שליחת בקשות לגבי סמל המיקום וצבע הרקע

בטבלאות הבאות מוצגים כל סמלי המקומות הזמינים לפי קטגוריה. כברירת מחדל, הם מוצגים עם גליף שחור. צבע הרקע של הסמל נקבע לפי הקטגוריה של המקום.

קטגוריית המקום: מזון ומשקאות
(צבע הרקע של הסמל: #FF9E67)
בר
בר,
מועדון לילה
בית קפה
בית קפה
מסעדה
מסעדה, מאפייה
קטגוריית המקום: קמעונאות
(צבע הרקע של הסמל: #4B96F3)
חנות ספרים
ספרים, בגדים, אלקטרוניקה, תכשיטים, נעליים,
מרכז קניות
חנות נוחות
חנות נוחות
מכולת
מכולת, סופרמרקט
בית מרקחת
בית מרקחת
קטגוריית המקום: שירותים
(צבע הרקע של הסמל הוא #909CE1)
כספומט
כספומט
בנק
בנק
דלק
גז
לינה
לינה
סניף דואר
סניף דואר
קטגוריית המקום: בידור
(צבע הרקע של הסמל: #13B5C7)
אקווריום, תיירותי
אקווריום, תיירות
גולף
גולף
היסטורי
היסטורי
סרט
סרט
מוזיאון
מוזיאון
תיאטרון
תיאטרון
קטגוריית המקום: תחבורה
(צבע הרקע של הסמל הוא #10BDFF)
נמל תעופה
שדה תעופה
אוטובוס
אוטובוס, נסיעה משותפת, מונית
רכבת/מסילה
רכבת/מסילה
קטגוריית המקום: עירוני/כללי/דתי
(צבע הרקע של הסמל: #7B9EB0)
בית קברות
בית קברות
מבנה ציבורי
מבנה ציבורי
ספרייה
Library
אנדרטה
אנדרטה
חניה
חניה
בית ספר (יסודי, תיכון, אוניברסיטה)
בית ספר (יסודי, תיכון, אוניברסיטה)
טקסים דתיים (נוצריים)
טקסים רוחניים (נוצריים)
פולחן (הינדי)
טקסים רוחניים (הינדי)
פולחן (אסלאם)
פולחן (איסלאם)
טקסים דתיים (ג&#39;ייני)
טקסים רוחניים (ג'ייני)
טקסים דתיים (יהודיים)
טקסים רוחניים (יהודיים)
טקסים דתיים (סיקי)
טקסים רוחניים (סיקי)
עסק כללי
עסק כללי
קטגוריית המקום: חוץ
(צבע הרקע של הסמל: #4DB546)
שייט בסירה
שייט בסירה
מחנאות
קמפינג
פארק
פארק
אצטדיון
אצטדיון
גן חיות
גן חיות
קטגוריית מקום: חירום
(צבע הרקע של הסמל הוא #F88181)
בית חולים
בית חולים
משטרה
משטרה