View a markdown version of this page

How to get suggestions with travel mode - Amazon Location Service
Potential use casesExamplesDeveloper tips

How to get suggestions with travel mode

Use TravelMode in Suggest requests to improve the relevance of place suggestions based on the user's mode of transportation.

Potential use cases

  • Fleet apps: Suggest truck-friendly stops and services as drivers type their query.

  • Ride-sharing: Prioritize relevant pickup and drop-off locations based on vehicle type.

Examples

Sample request
{
    "QueryText": "parking",
    "BiasPosition": [-122.3321, 47.6062],
    "TravelMode": "Scooter"
}
Sample response
{
    "ResultItems": [
        {
            "Title": "Pacific Place Parking, Seattle, WA",
            "SuggestResultItemType": "Place",
            "Place": {
                "PlaceId": "<Redacted>",
                "PlaceType": "PointOfInterest",
                "Distance": 830
            }
        }
    ]
}
cURL
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/suggest?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "parking",
    "BiasPosition": [-122.3321, 47.6062],
    "TravelMode": "Scooter"
}'
AWS CLI
aws geo-places suggest --key ${YourKey} --query-text "parking" --bias-position -122.3321 47.6062 --travel-mode Scooter

Developer tips

  • Valid values are Car, Scooter, and Truck.

  • TravelMode improves relevance but does not filter results.