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