Method: findPickupPointsForLocation

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

HTTP 要求

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

這個網址使用 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)

搜尋位置附近的 Wi-Fi 存取點。用於提供高品質的搜尋結果。

回應主體

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

找出位置回覆訊息的取貨地點。

JSON 表示法
{
  "placePickupPointResults": [
    {
      object (PlacePickupPointResult)
    }
  ],
  "placeResults": [
    {
      object (PlaceResult)
    }
  ]
}
欄位
placePickupPointResults[]

object (PlacePickupPointResult)

具有關聯地點 ID 的附近上車地點。這份清單中的結果會根據要求中的條件排序。「placePickupPointResults」中的結果數量可能會超過「placeResults」的結果數量。

placeResults[]

object (PlaceResult)

與附近上車地點相關聯的地點詳細資料。這份清單中的結果不會排序。

PlacePickupPointResult

附有相關地點 ID 的取貨地點。

JSON 表示法
{
  "pickupPointResult": {
    object (PickupPointResult)
  },
  "associatedPlaceId": string
}
欄位
pickupPointResult

object (PickupPointResult)

上車地點詳細資料。這是必填欄位。

associatedPlaceId

string

相關地點的地點 ID。