Places API (החדש) כולל את ממשקי ה-API הבאים:
במסמך הזה תמצאו סקירה כללית של ממשקי ה-API החדשים.
פרטי מקום (חדש)
מזהה מקום משמש לזיהוי ייחודי של מקום במסד הנתונים של כתובות ב-Google ובמפות Google. בעזרת מזהה מקום אפשר לבקש פרטים על מוסד או נקודת עניין מסוימים על ידי שליחת בקשה מסוג פרטי מקום (חדש). אם מבקשים פרטי מקום (חדש) מקבלים מידע מקיף על המקום שצוין, כמו הכתובת המלאה, מספר הטלפון, דירוג המשתמשים והביקורות שלו.
יש הרבה דרכים לקבל מזהה מקום. אתם יכולים להשתמש:
- חיפוש טקסט (חדש)
- חיפוש בקרבת מקום (חדש)
- Geocoding API
- Routes API
- API לאימות כתובת
- השלמה אוטומטית למקומות
תמונה של מקום (חדש)
בעזרת Place Photo (New) API אפשר להוסיף לאפליקציה תוכן תמונות באיכות גבוהה, על ידי גישה למיליוני התמונות שמאוחסנים במסד הנתונים של מקומות Google. תוכלו לגשת לתמונות ולשנות את הגודל שלהן בהתאם לגודל האופטימלי לאפליקציה שלכם באמצעות ה-API של תמונת המקום (New).
כל הבקשות ל-API של תמונת מקום (חדש) חייבות לכלול שם של משאב תמונות, שמזהה באופן ייחודי את התמונה שתוחזר. אפשר לקבל את השם של מקור התמונות באמצעות:
כדי לכלול את השם של מקור התמונה בתשובה מבקשה של פרטי מקום (חדש), חיפוש טקסט (חדש) או חיפוש בקרבת מקום (חדש), חשוב לכלול את השדה photos
במסכת השדות של הבקשה.
חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש)
Places API כולל שני ממשקי API לחיפוש:
-
מאפשרת לציין מחרוזת טקסט שעליה תחפש מקום מסוים. לדוגמה: "אוכל צמחוני חריף בסידני, אוסטרליה" או "מסעדת מאכלי ים טובה ליד פאלו אלטו, קליפורניה".
אפשר לצמצם את החיפוש על ידי ציון פרטים כמו רמות מחירים, סטטוס הפתיחה הנוכחי, דירוגים או סוגים ספציפיים של מקומות. אפשר גם לציין כדי להטות את התוצאות למיקום ספציפי או להגביל את החיפוש למיקום ספציפי.
-
ההגדרה הזאת מאפשרת לציין אזור לחיפוש יחד עם רשימה של סוגי מקומות. מציינים את האזור כעיגול לפי הקואורדינטות של קו הרוחב וקו האורך של נקודת המרכז והרדיוס במטרים.
מציינים סוג אחד או יותר של מקום שמגדירים את המאפיינים של המקום. לדוגמה, מציינים '
pizza_restaurant
' ו-'shopping_mall
' כדי לחפש פיצרייה שנמצאת בקניון באזור שצוין.
ההבדל העיקרי בין שני החיפושים הוא שחיפוש טקסט (חדש) מאפשר לציין מחרוזת חיפוש שרירותית, ואילו התכונה 'חיפוש בקרבת מקום' (חדש) דורשת אזור ספציפי שבו יש לבצע חיפוש.
השלמה אוטומטית (חדשים) ואסימוני סשן
השלמה אוטומטית (חדש) הוא שירות אינטרנט שמחזיר חיזויים של מקומות וחיזויים של שאילתות בתגובה לבקשת HTTP. בבקשה מציינים מחרוזת חיפוש טקסט וגבולות גיאוגרפיים ששולטים באזור החיפוש.
אסימוני סשן הם מחרוזות שנוצרות על ידי משתמשים ועוקבות אחרי הפעלות של השלמה ��וטומטית (חדש) כסשנים. התכונה 'השלמה אוטומטית (חדש)' משתמשת באסימוני סשן כדי לקבץ את שלבי השאילתות והבחירה של החיפוש האוטומטי של המשתמש לסשן נפרד למטרות חיוב.
שדות, מאפיינים ואפשרויות נגישות חדשים
Places API (חדש) כולל שדות, מאפיינים ואפשרויות נגישות חדשים כדי לספק למשתמשים מידע נוסף על מקום מסוים. ההיבטים האלה מתוארים בקטעים הבאים.
שדות
Places API (חדש) כולל כמה שדות חדשים:
שדה | תיאור |
---|---|
regularSecondaryOpeningHours |
מתאר זמנים מסוימים לפעולות מסוימות. שעות הפתיחה המשניות שונות משעות הפעילות העיקריות של העסק. לדוגמה, מסעדה יכולה לציין את שעות הנסיעה או את שעות המשלוח כשעות משניות של מסעדה. |
paymentOptions |
אפשרויות התשלום שהמקום מקבל. מקום יכול לקבל יותר
מאפשרויות תשלום אחת. אם הנתונים של אפשרות התשלום לא זמינים, השדה של אפשרות התשלום לא יהיה מוגדר. האפשרויות כוללות:
|
parkingOptions |
אפשרויות החניה שמסופקות על ידי המקום. האפשרויות כוללות:
|
subDestinations |
מקומות ייחודיים שקשורים למקום מסוים. לדוגמה, טרמינלים של נמלי תעופה נחשבים ליעדי משנה של שדה תעופה. |
fuelOptions |
המידע העדכני ביותר על אפשרויות דלק זמין
בתחנת דלק. המידע הזה מתעדכן באופן קבוע. האפשרויות כוללות:
|
evChargeOptions |
מספר המטענים לרכב חשמלי (EV) בתחנה הזו. לחלק מהמטענים לרכב חשמלי יש כמה מחברים, אבל כל מטען יכול להטעין רק רכב אחד בכל פעם. כתוצאה מכך, השדה הזה משקף את מספר המטענים הזמינים כרגע. |
shortFormattedAddress |
כתובת קצרה של מקום, שבודק אנושי יכול לקרוא. |
primaryType |
הסוג הראשי של התוצאה הנתונה. לדוגמה:
מקום יכול להיות מסווג כcafe או כairport . למקום יכול להיות רק סוג ראשי אחד. הרשימה המלאה של הערכים האפשריים זמינה במאמר סוגים נתמכים. |
primaryTypeDisplayName |
השם המוצג של הסוג הראשי, שמותאם לשפת הבקשה, אם רלוונטי. הרשימה המלאה של הערכים האפשריים זמינה במאמר סוגים נתמכים. |
מאפיינים
Places API (החדש) כולל מספר מאפיינים חדשים:
מאפיין | תיאור |
---|---|
outdoorSeating |
יש במקום מקומות ישיבה בחוץ. |
liveMusic |
במקום יש מופעי מוזיקה חיים. |
menuForChildren |
יש במקום תפריט ילדים. |
servesCocktails |
במקום מוגשים קוקטיילים. |
servesDessert |
קינוחים במקום. |
servesCoffee |
במקום מגישים קפה. |
goodForChildren |
המקום מתאים לילדים. |
allowsDogs |
מותר להכניס כלבים. |
restroom |
במקום יש שירותים. |
goodForGroups |
המקום יכול להתארח בקבוצות. |
goodForWatchingSports |
המקום מתאים לצפייה באירועי ספורט. |
אפשרויות של נגישות
Places API (חדש) כולל את השדות הבאים של אפשרויות נגישות:
שדה | תיאור |
---|---|
wheelchairAccessibleParking |
במקום יש חניה נגישה לכיסאות גלגלים. |
wheelchairAccessibleEntrance |
יש במקום כניסה נגישה לכיסאות גלגלים. |
wheelchairAccessibleRestroom |
במקום יש שירותים נגישים לכיסאות גלגלים. |
wheelchairAccessibleSeating |
במקום יש מקומות ישיבה נגישים לכיסאות גלגלים. |
מעבר לממשקי ה-API של מקומות חדשים
אם אתם לקוחות קיימים של Places API ואתם רוצים להעביר את האפליקציה שלכם לשימוש בממשקי ה-API החדשים, עיינו במאמרי העזרה הבאים בנושא העברה: