Places API (חדש) כולל את ממשקי ה-API הבאים:
במסמך הזה מופיעה סקירה כללית על ממשקי ה-API החדשים האלה.
פרטי המקום (חדש)
מזהה מקום הוא מזהה ייחודי של מקום במסד הנתונים של מקומות Google ובמפות Google. באמצעות מזהה מקום, אפשר לשלוח בקשה לקבלת פרטים על מקום ספציפי או על אתר תיירותי ספציפי. לשם כך, צריך לשלוח בקשה מסוג פרטי מקום (חדש). בקשה מסוג 'פרטי מקום (חדש)' מחזירה מידע מקיף על המקום שצוין, כמו הכתובת המלאה, מספר הטלפון, הדירוג של המשתמשים והביקורות.
יש הרבה דרכים לקבל מזהה מקום. אפשר להשתמש:
- חיפוש טקסט (חדש)
- חיפוש בקרבת מקום (חדש)
- Geocoding API
- Routes API
- Address Validation API
- השלמה אוטומטית למקומות
תמונה של המקום (חדש)
Place Photo API (חדש) מאפשר לכם להוסיף לאפליקציה תוכן צילום באיכות גבוהה, באמצעות גישה למיליוני התמונות שמאוחסנות במסד הנתונים של Google Places. באמצעות Place Photo API (חדש), תוכלו לגשת לתמונות ולשנות את גודל התמונה לגודל האופטימלי לאפליקציה שלכם.
כל הבקשות ל-Place Photo API (החדש) חייבות לכלול שם של משאב תמונה, שמזהה באופן ייחודי את התמונה שתוחזר. אפשר לקבל את שם משאב התמונה באמצעות:
כדי לכלול את שם המשאב של התמונה בתגובה לבקשה של פרטי מקום (חדש), חיפוש טקסט (חדש) או חיפוש בקרבת מקום (חדש), צריך לכלול את השדה photos
במסכת השדות של הבקשה.
חיפוש טקסט (חדש) וחיפוש בקרבת מקום (חדש)
Places API כולל שני ממשקי API לחיפוש:
-
מאפשר לציין מחרוזת טקסט שבה יתבצע חיפוש של מקום. לדוגמה: "אוכל צמחוני חריף בסידני, אוסטרליה" או "מסעדת מאכלי ים יוקרתית ליד Palo Alto, קליפורניה".
אפשר לצמצם את החיפוש על ידי ציון פרטים כמו רמות מחיר, סטטוס פתיחה נוכחי, דירוגים או סוגי מקומות ספציפיים. אפשר גם לציין הטיה של התוצאות למיקום ספציפי, או להגביל את החיפוש למיקום ספציפי.
-
מאפשרת לציין אזור לחיפוש ורשימה של סוגי מקומות. מציינים את האזור כמעגל שמוגדר לפי קו הרוחב וקו האורך של נקודת המרכז והרדיוס במטרים.
מציינים סוג מקום אחד או יותר שמגדיר את המאפיינים של המקום. לדוגמה, מציינים את הערכים '
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 |
יש מקומות ישיבה נגישים לכיסאות גלגלים. |
מעבר לממשקי Places API החדשים
אם אתם לקוחות קיימים של Places API ואתם רוצים להעביר את האפליקציה שלכם כך שתשתמש בממשקי ה-API החדשים, תוכלו לעיין במסמכי העזרה הבאים בנושא העברה: