סמלי המקומות מציינים את הסוגים השונים של מקומות (לדוגמה, בתי קפה, ספריות ומוזיאונים). אפשר לבקש כתובות URL לסמלים בפורמט PNG או SVG, וכן את צבע הרקע המתאים של הסמל, באמצעות בקשות מסוג 'חיפוש מקום', 'פרטי מקום', 'חיפוש בקרבת מקום' ו'חיפוש טקסט'. אפשר להשתמש בסמלים בתוך השורה.
כל סמל מוגדר באמצעות שני שדות תגובה:
- ה-URI הבסיסי של הסמל מכיל את כתובת ה-URL הבסיסית של סמל ללא צבע, ללא סיומת סוג הקובץ. כדי לבקש את הסמל, עליך לצרף את הערכים
.svg
או.png
ל-URI. - צבע הרקע של הסמל מכיל את קוד הצבע HEX שמוגדר כברירת מחדל לקטגוריה של המקום.
דוגמה
הדוגמאות הבאות מראות איך לבקש סמל 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) |
|||
בית חולים |
משטרה |