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