דף זה תורגם על ידי Cloud Translation API.

סמלי מקומות

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

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

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

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

כתובות ה-URL של הסמלים עשויות להשתנות, לכן חשוב להשתמש תמיד ב-URI על בסיס סמל כדי לחפש את כתובת ה-URL של הסמל. ב-Places API הקיים יש תמיכה בשדה התגובה icon. אין להשתמש בשדה icon, אלא ב-icon_background_color וב-icon_mask_base_uri יחד עם ממשק Places API הקיים.

דוגמה

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

Places API (חדש)

בדוגמה הבאה נשתמש בחיפוש טקסט (חדש) כדי להציג את השם המוצג של המקום, וגם את שדות התגובה 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"
      }
    }
  ]
}

Places API

בדוגמה הבאה מוצגת בקשה חיפוש מקום שכוללת את השדות 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 מופיעים בתגובה לבקשת חיפוש מקום.

JSON

    {
      "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"
    }

XML

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