Query

路线便利设施停靠点

使用 getRouteStationsWithAmenities 查询在路线上的某一点搜索带有便利设施的充电站。当您想在餐厅、商店或其他便利设施附近规划充电停靠点时，此操作非常有用。

查询

沿路线搜索充电站需要 route_id、route_details_id、time_window 和 amenity_types。两个 ID 都可通过 getRoute 查询获取。使用 filter 参数根据特定条件缩小结果范围，并使用 first 和 after 参数对结果进行分页。

此查询的 first 不能超过 10。

参数

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.

字段

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.

错误

操作可能会失败。请考虑以下错误场景以正确处理。有关错误的更多信息 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.

此内容是否有帮助？