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