View a markdown version of this page

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

How to search with travel mode

TravelMode indicates your mode of mobility. This improves the relevance of search results. For example, a search for "EV charging station" returns charging stations suitable for trucks when TravelMode is set to Truck.

Potential use cases

  • Fleet management: Find fuel stations or rest stops that accommodate trucks or commercial vehicles.

  • Navigation apps: Provide more relevant results based on whether the user is driving a car, riding a scooter, or operating a truck.

Examples

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

Developer tips

  • Valid values are Car, Scooter, and Truck.

  • TravelMode improves relevance but does not filter results. Results may still include places that are not specific to the travel mode.