Skip to main content
Query

Route amenity stop

Search for charging stations with amenities at a certain point along a route by using the getRouteStationsWithAmenities query. This is useful when you want to plan a charging stop near restaurants, shops, or other amenities.

Query

A route_id, route_details_id, time_window, and amenity_types are required to search for stations along a route. Both ids can be obtained through the getRoute query. Use the filter argument to narrow the results down based on specific criteria, and the first and after arguments to paginate through them.

Arguments

route_id· ID· required
ID of the route request.
route_details_id· ID· required
ID of the route.
time_window· RouteTimeWindow· required
Time window along the route to search for stations with amenities.
amenity_types· AmenityType· required
Type of amenity to search along the route. Behaves as logical OR when multiple values are provided.
AmenityType enum values
park

restaurant

museum

coffee

hotel

shopping

bathroom

supermarket

playground

pharmacy

bakery

convenience_store

filter· RouteStationsWithAmenityFilter
Filter results by station or amenity properties.
first· Int
Maximum number of items to return per page, a value between 1 and 10.
after· String
Returns the items in the list that come after the specified cursor. For the first page, this field should not be specified.

Fields

total_count· Int
Total number of stations with amenities of the specified type.
page_info· PageInfo
Information about the current page.
nodes· RouteStationWithAmenities
List of stations with amenities of the specified type.

Operations can fail. Account for the following error scenarios to handle them correctly. More on errors here.

maximum_distance_from_path_above_allowed
Provided maximum distance from path is not valid. The value must be less than or equal to 10 000 meters or an equivalent unit.
maximum_distance_from_station_above_allowed
Provided maximum distance from station is not valid. The value must be less than or equal to 1000 meters or an equivalent unit.
pagination_invalid_after
The cursor provided in $LOCATION is invalid.
pagination_invalid_first
The page size indicated in $LOCATION must value between 1 and $SIZE.
route_amenities_expired
This route has expired for this type of search. To ensure data accuracy, routes older than 24 hours cannot be used. Please create a new route and try again.
route_amenities_invalid_status
Cannot search stations and amenities in a route with status [object Object].
route_not_found
No route was found with the provided ID.
time_window_exceeds_route_duration
The specified time window center takes place after the estimated arrival time. All center times must take place between the estimated departure and arrival time.
time_window_margin_above_allowed
Provided time window margin is not valid. The value must be less than or equal to 45 minutes or an equivalent unit.
zero_or_negative_value_not_allowed
Zero or negative value for $LOCATION is not allowed.

Was this content helpful?

Developers

Chargetrip ©

Status unknown

Manage cookies

Effective: 20th March, 2024 · Updated: 1 September, 2026

We use cookies to help improve your experience of developers.chargetrip.com. This cookie policy is part of the privacy policy, and covers the use of cookies between your device and our site. We also provide basic information on third-party services we may use, who may also use cookies as part of their service, though they are not covered by our policy.

If you don’t wish to accept any cookies from us, you should instruct your browser to refuse cookies from developers.chargetrip.com, with the understanding that we may be unable to provide you with some of your desired content and services.

A cookie is a small piece of data that a website stores on your device when you visit, typically containing information about the website itself, a unique identifier that allows the site to recognize your web browser when you return, additional data that serves the purpose of the cookie itself, and the lifespan of the cookie itself.

Cookies are used to enable certain features (e.g. logging in), to track site usage (e.g. analytics), to store your user settings (e.g. timezone, notification preferences), and to personalize your content (e.g. advertising, language).

Cookies set by the website you are visiting are normally referred to as “first-party cookies,” and typically only track your activity on that particular site. Cookies set by other sites and companies (i.e. third parties) can be used to track you on other websites that use the same third-party service.

Essential cookies

Cookies set by the website you are visiting are normally referred to as “first-party cookies,” and typically only track your activity on that particular site. Cookies set by other sites and companies (i.e. third parties) can be used to track you on other websites that use the same third-party service.

Performance cookies

Targeting / advertising cookies are used in determining what promotional content is more relevant and appropriate to you and your interests. Websites may use them to deliver targeted advertising or to limit the number of times you see an advertisement. This helps companies improve the effectiveness of their campaigns and the quality of content presented to you. These cookies may be set by the website you’re visiting (first-party) or by third-party services. Targeting/advertising cookies set by third parties may be used to track you on other websites that use the same third-party service. We use targeting/advertising cookies on our site.

Marketing / advertising cookies

Targeting / advertising cookies are used in determining what promotional content is more relevant and appropriate to you and your interests. Websites may use them to deliver targeted advertising or to limit the number of times you see an advertisement. This helps companies improve the effectiveness of their campaigns and the quality of content presented to you. These cookies may be set by the website you’re visiting (first-party) or by third-party services. Targeting/advertising cookies set by third parties may be used to track you on other websites that use the same third-party service. We use targeting/advertising cookies on our site.

Third party promise

We review the privacy policies of all our third-party providers before enlisting their services to ensure their practices align with ours. We will never knowingly include third-party services that compromise or violate the privacy of our users.

Cookie
google-cookie-consent
Description
Stores your cookie preferences, meaning which categories you have accepted or declined, so we can respect your choice on every visit and only load the analytics or marketing tools you have allowed.
Lifetime
2 years

How you can control or opt out of cookies

If you do not wish to accept cookies from us, you can instruct your browser to refuse cookies from our website. Most browsers are configured to accept cookies by default, but you can update these settings to either refuse cookies altogether or to notify you when a website is trying to set a cookie.

If you browse websites from multiple devices, you may need to update your settings on each individual device.

Although some cookies can be blocked with little impact on the experience of a website, blocking all cookies may mean you are unable to access certain features and content across the sites you visit.

We may update this Cookie Policy from time to time in order to reflect, for example, changes to the cookies we use or for other operational, legal, or regulatory reasons. Please re-visit this Cookie Policy to stay informed about our use of cookies and related technologies. The date at the top of this Cookie Policy indicates when it was last updated.