מחפשים נקודות איסוף של מקום נתון.
בקשת HTTP
POST https://locationselection.googleapis.com/v1beta:findPickupPointsForPlace
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "placeId": string, "localizationPreferences": { object ( |
שדות | |
---|---|
placeId |
חובה. המזהה של המקום שעבורו מבקשים את נקודות האיסוף. |
localizationPreferences |
חובה. העדפות שמשמשות להתאמה לשוק המקומי של טקסטים בתגובה, לדוגמה, שם וכתובת. |
searchLocation |
מיקום לשימוש לצורך חיפוש נקודות איסוף ולחישוב מרחקים וזמני הגעה משוערים אל נקודות איסוף. אם המדיניות לא מוגדרת, המערכת תשתמש במיקום של המקום שמשויך למזהה המקום הנתון. |
orderBy |
חובה. סדר לשימוש בעת החזרת תוצאות. |
destination |
מיקום היעד של הלקוח. ההגדרה הזו קובעת אם רוצים לבקש נקודות איסוף שיוזמנו לפי זמן ההגעה המשוער ליעד. |
maxResults |
חובה. המספר המקסימלי של תוצאות להחזרה. חייב להיות גדול מ-0. |
travelModes[] |
חובה. המערכת מחזירה רק נקודות איסוף שמאפשרות הצגה של לפחות אחד מאפשרויות הנסיעה שצוין. מצבי נסיעה נתמכים: DRIVING ו-TWO_WHEELER. יש לציין מצב אחד לפחות. |
computeWalkingEta |
אם הערך הוא True, יתבצע חישוב של זמן ההגעה המשוער בהליכה ממיקום החיפוש עד לנקודת האיסוף. |
computeDrivingEta |
אם צוין True ויעד, יחושב זמן ההגעה המשוער מנקודת האיסוף אל היעד. |
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
מאתרים נקודות איסוף להודעת התגובה לגבי המקום.
ייצוג JSON |
---|
{ "pickupPointResults": [ { object ( |
שדות | |
---|---|
pickupPointResults[] |
נקודות איסוף שתואמות לקריטריוני הבקשה. אם אין נקודות איסוף שתואמות לקריטריונים של הבקשה, אפשר להשאיר את השדה ריק. |
placeResult |
המקום המשויך למזהה המקום הנתון בבקשה. |