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