Method: findPickupPointsForLocation

חיפוש נקודות איסוף במיקום נתון.

בקשת HTTP

POST https://locationselection.googleapis.com/v1beta:findPickupPointsForLocation

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "localizationPreferences": {
    object (LocalizationPreferences)
  },
  "searchLocation": {
    object (LatLng)
  },
  "orderBy": enum (PickupPointOrder),
  "destination": {
    object (LatLng)
  },
  "maxResults": integer,
  "travelModes": [
    enum (TravelMode)
  ],
  "computeWalkingEta": boolean,
  "computeDrivingEta": boolean,
  "wifiAccessPoints": [
    {
      object (WiFiAccessPoint)
    }
  ]
}
שדות
localizationPreferences

object (LocalizationPreferences)

חובה. ההעדפות שמשמשות ללוקליזציה של הטקסטים בתשובה, למשל שם וכתובת.
searchLocation

object (LatLng)

חובה. המיקום שמשמש לחיפוש נקודות איסוף ולחישוב מרחקים וזמני הגעה משוערים לנקודות איסוף.
orderBy

enum (PickupPointOrder)

חובה. סדר להצגת התוצאות.
destination

object (LatLng)

מיקום היעד המתוכנן של הלקוח. מגדירים כשמבקשים את נקודות האיסוף, ממוינות לפי זמן ההגעה המשוער ליעד.
maxResults

integer

חובה. המספר המקסימלי של תוצאות שיוחזר. הערך חייב להיות גדול מ-0.
travelModes[]

enum (TravelMode)

חובה. יוחזרו רק נקודות איסוף שמאפשרות לפחות אחד ממצב הנסיעה שצוין. מצבי נסיעה נתמכים: DRIVING ו-TWO_WHEELER. צריך לציין לפחות מצב אחד.
computeWalkingEta

boolean

אם True, יחושב זמן ההגעה המשוער להליכה ממיקום החיפוש אל נקודת האיסוף.
computeDrivingEta

boolean

אם מציינים את הערך True ואת היעד, המערכת מחשבת את זמן ההגעה המשוער בנסיעה מנקודת האיסוף אל היעד.
wifiAccessPoints[]

object (WiFiAccessPoint)

נקודות גישה (AP) של Wi-Fi מסביב למיקום החיפוש. הצגה של תוצאות חיפוש באיכות גבוהה יותר.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

חיפוש נקודות איסוף להודעת התשובה לגבי המיקום.

ייצוג ב-JSON 
{
  "placePickupPointResults": [
    {
      object (PlacePickupPointResult)
    }
  ],
  "placeResults": [
    {
      object (PlaceResult)
    }
  ]
}
שדות
placePickupPointResults[]

object (PlacePickupPointResult)

נקודות איסוף בקרבת מקום עם מזהה המקום המשויך. התוצאות ברשימה הזו מסודרות לפי הקריטריונים שצוינו בבקשה. יכול להיות שמספר התוצאות בשדה 'placepickupPoint Results' גבוה ממספר התוצאות שהתקבלו ב-'placePlace Results' (תוצאות).
placeResults[]

object (PlaceResult)

פרטים על המקומות שמשויכים לנקודות איסוף בקרבת מקום. התוצאות ברשימה הזו לא ממוינות.

PlacePickupPointResult

נקודות איסוף עם מזהה מקום משויך.

ייצוג JSON 
{
  "pickupPointResult": {
    object (PickupPointResult)
  },
  "associatedPlaceId": string
}
שדות
pickupPointResult

object (PickupPointResult)

פרטים על נקודת האיסוף. הנוכחות חייבת להופיע.
associatedPlaceId

string

מזהה המקום של המקום המשויך.