Method: findPickupPointsForPlace
Stay organized with collections
Save and categorize content based on your preferences.
Find pickup points for a given place.
HTTP request
POST https://locationselection.googleapis.com/v1beta:findPickupPointsForPlace
The URL uses gRPC Transcoding syntax.
Request body
The request body contains data with the following structure:
| JSON representation |
{
"placeId": string,
"localizationPreferences": {
object (LocalizationPreferences)
},
"searchLocation": {
object (LatLng)
},
"orderBy": enum (PickupPointOrder),
"destination": {
object (LatLng)
},
"maxResults": integer,
"travelModes": [
enum (TravelMode)
],
"computeWalkingEta": boolean,
"computeDrivingEta": boolean
} |
| Fields |
placeId |
string
Required. Place ID of the place for which pick-up points are requested.
|
localizationPreferences |
object (LocalizationPreferences)
Required. Preferences used for localizing the texts in response, for example, name and address.
|
searchLocation |
object (LatLng)
Location to use for searching pickup points and calculating distances and ETAs to pickup points. If not set, the location of the place associated with the given place id is used.
|
orderBy |
enum (PickupPointOrder)
Required. Ordering to use when returning results.
|
destination |
object (LatLng)
Customer's intended destination location. Set if requesting pickup points to be ordered by destination ETA.
|
maxResults |
integer
Required. Maximum number of results to be returned. Must be greater than 0.
|
travelModes[] |
enum (TravelMode)
Required. Only pickup points that allow at least one of the specified travel mode are returned. Supported travel modes: DRIVING and TWO_WHEELER. At least one mode must be specified.
|
computeWalkingEta |
boolean
If true, the walking ETA from the search location to the pickup point is computed.
|
computeDrivingEta |
boolean
If true and destination is specified, the driving ETA from the pickup point to the destination is computed.
|
Response body
If successful, the response body contains data with the following structure:
Find pickup points for place response message.
| Fields |
pickupPointResults[] |
object (PickupPointResult)
Pick-up points that match the request criteria. May be empty if no pickup points match the request criteria.
|
placeResult |
object (PlaceResult)
Place associated with given place id in request.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-27 UTC."],[[["\u003cp\u003eThis document describes the \u003ccode\u003efindPickupPointsForPlace\u003c/code\u003e API, which allows you to retrieve pickup points for a specified place.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires parameters such as \u003ccode\u003eplaceId\u003c/code\u003e, \u003ccode\u003elocalizationPreferences\u003c/code\u003e, \u003ccode\u003eorderBy\u003c/code\u003e, and \u003ccode\u003etravelModes[]\u003c/code\u003e, among others, to define the search criteria.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of pickup points (\u003ccode\u003epickupPointResults[]\u003c/code\u003e) matching the request, along with details about the specified place (\u003ccode\u003eplaceResult\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003ePickup points are ranked according to the \u003ccode\u003eorderBy\u003c/code\u003e parameter and filtered based on travel modes, location, and other preferences.\u003c/p\u003e\n"],["\u003cp\u003eYou can use this API to identify suitable pickup locations for ride-hailing, delivery, or other location-based services.\u003c/p\u003e\n"]]],[],null,["# Method: findPickupPointsForPlace\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.FindPickupPointsForPlaceResponse.SCHEMA_REPRESENTATION)\n\nFind pickup points for a given place.\n\n### HTTP request\n\n`POST https://locationselection.googleapis.com/v1beta:findPickupPointsForPlace`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"placeId\": string, \"localizationPreferences\": { object (/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/LocalizationPreferences) }, \"searchLocation\": { object (/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/LatLng) }, \"orderBy\": enum (/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/PickupPointOrder), \"destination\": { object (/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/LatLng) }, \"maxResults\": integer, \"travelModes\": [ enum (/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/TravelMode) ], \"computeWalkingEta\": boolean, \"computeDrivingEta\": boolean } ``` |\n\n| Fields ||\n|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `placeId` | `string` Required. Place ID of the place for which pick-up points are requested. |\n| `localizationPreferences` | `object (`[LocalizationPreferences](/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/LocalizationPreferences)`)` Required. Preferences used for localizing the texts in response, for example, name and address. |\n| `searchLocation` | `object (`[LatLng](/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/LatLng)`)` Location to use for searching pickup points and calculating distances and ETAs to pickup points. If not set, the location of the place associated with the given place id is used. |\n| `orderBy` | `enum (`[PickupPointOrder](/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/PickupPointOrder)`)` Required. Ordering to use when returning results. |\n| `destination` | `object (`[LatLng](/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/LatLng)`)` Customer's intended destination location. Set if requesting pickup points to be ordered by destination ETA. |\n| `maxResults` | `integer` Required. Maximum number of results to be returned. Must be greater than 0. |\n| `travelModes[]` | `enum (`[TravelMode](/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/TravelMode)`)` Required. Only pickup points that allow at least one of the specified travel mode are returned. Supported travel modes: DRIVING and TWO_WHEELER. At least one mode must be specified. |\n| `computeWalkingEta` | `boolean` If true, the walking ETA from the search location to the pickup point is computed. |\n| `computeDrivingEta` | `boolean` If true and destination is specified, the driving ETA from the pickup point to the destination is computed. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nFind pickup points for place response message.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"pickupPointResults\": [ { object (/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/PickupPointResult) } ], \"placeResult\": { object (/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/PlaceResult) } } ``` |\n\n| Fields ||\n|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pickupPointResults[]` | `object (`[PickupPointResult](/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/PickupPointResult)`)` Pick-up points that match the request criteria. May be empty if no pickup points match the request criteria. |\n| `placeResult` | `object (`[PlaceResult](/maps/documentation/mobility/location-selection-api/reference/rest/v1beta/PlaceResult)`)` Place associated with given place id in request. |"]]