Method: findPickupPointsForPlace

找出特定地點的上車地點,

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "placeId": string,
  "localizationPreferences": {
    object (LocalizationPreferences)
  },
  "searchLocation": {
    object (LatLng)
  },
  "orderBy": enum (PickupPointOrder),
  "destination": {
    object (LatLng)
  },
  "maxResults": integer,
  "travelModes": [
    enum (TravelMode)
  ],
  "computeWalkingEta": boolean,
  "computeDrivingEta": boolean
}
欄位
placeId

string

必要欄位。要求取貨地點的地點 ID。

localizationPreferences

object (LocalizationPreferences)

必要欄位。用於將回應文字 (例如姓名和地址) 本地化的偏好設定。

searchLocation

object (LatLng)

這個位置可用來搜尋上車地點,以及計算前往上車地點的距離和預計到達時間。如未設定,系統會使用與指定地點 ID 相關聯的地點位置。

orderBy

enum (PickupPointOrder)

必要欄位。傳回結果時使用的排序方式。

destination

object (LatLng)

客戶前往的目的地位置。如果要求依目的地預計到達時間訂購取貨地點,請設定。

maxResults

integer

必要欄位。要傳回的結果數上限。必須大於 0。

travelModes[]

enum (TravelMode)

必要欄位。系統只會傳回允許至少一種指定交通方式的上車點。支援的交通方式:DRIVING 和 TWO_WHEELER。至少須指定一個模式。

computeWalkingEta

boolean

如果為 true,則會計算從搜尋位置到取貨地點的步行預計到達時間。

computeDrivingEta

boolean

如果指定 true 和目的地,系統就會計算從上車點到目的地的行車時間。

回應主體

如果成功,回應主體即會包含具有以下結構的資料:

找出地點回應訊息的取貨地點。

JSON 表示法
{
  "pickupPointResults": [
    {
      object (PickupPointResult)
    }
  ],
  "placeResult": {
    object (PlaceResult)
  }
}
欄位
pickupPointResults[]

object (PickupPointResult)

符合要求條件的取貨地點,如果沒有符合要求條件的上車地點,則可留空。

placeResult

object (PlaceResult)

與要求中的指定地點 ID 相關聯的地點。