Servicearea

Servicearea#

Warning

Viewing documentation for the deprecated version v1beta1.

To switch to an other version use the following links:

v1beta2

The required Protobuf definitions can be downloaded here:

ServiceAreaService#

This ServiceAreaService provides methods to query Service Areas.

GetServiceArea#

rpc GetServiceArea(GetServiceAreaRequest) GetServiceAreaResponse

Get Service Area by ID. Returns NOT_FOUND if the Service Area does not exist.

ListServiceAreas#

rpc ListServiceAreas(ListServiceAreasRequest) ListServiceAreasResponse

List Service Areas, paginated. Returns an empty list if none are found.

ListServiceHours#

rpc ListServiceHours(ListServiceHoursRequest) ListServiceHoursResponse

List Service Hours for a Service Area.

Messages#

GetServiceAreaRequest#

The request to get a Service Area by ID.

Field	Type	Description
id	string	The ID of the Service Area.

GetServiceAreaResponse#

The response containing the requested Service Area.

Field	Type	Description
service_area	ServiceArea	The Service Area with the given ID.

ListServiceAreasRequest#

The request to list Service Areas.

Field	Type	Description
page_size (optional)	int32	The maximum number of Service Areas to return. The service may return fewer than this value. If unspecified, at most 5 Service Areas will be returned. The maximum value is 100; values above 100 will be coerced to 100.
page_token (optional)	string	A page token, received from a previous `ListServiceAreasRequest` call. Provide this to retrieve the subsequent page.

ListServiceAreasResponse#

The response containing Service Areas.

Field	Type	Description
service_areas	repeated ServiceArea	List of Service Areas.
next_page_token (optional)	string	A token, which can be sent as `page_token` in the next request to retrieve the next page. If this field is omitted, there are no subsequent pages.

ListServiceHoursRequest#

The request to list a Service Area’s Service Hours.

Field	Type	Description
service_area_id	string	The ID of the Service Area.
page_size (optional)	int32	The maximum number of Service Hours to return. The service may return fewer than this value. If unspecified, at most 25 Service Hours will be returned. The maximum value is 100; values above 100 will be coerced to 100.
page_token (optional)	string	A page token, received from a previous `ListServiceHoursResponse`. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListServiceHoursRequest` must match. the call that provided the page token.

ListServiceHoursResponse#

The list of a Service Area’s Service Hours.

Field	Type	Description
service_hours	repeated ServiceHours	The Service Hours.
service_area_id	string	The ID of the Service Area.
next_page_token (optional)	string	A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.

ServiceArea#

A Service Area is an area in the physical world where a ridepooling service is in operation.

Field	Type	Description
name	string	Unique name of the Service Area.
id	string	ID of the Service Area.
polygon	repeated moia.type.v1.LatLon	Polygon with a list of locations delineating the exact boundaries of the Service Area.
time_zone	string	Time zone ID in IANA Time Zone codes e.g. Europe/Berlin.
country	string	ISO 3166-1 alpha-2 country code of the country this Service Area is located in.
create_time	google.protobuf.Timestamp	Service Area creation date.
modify_time	google.protobuf.Timestamp	Service Area last modified date.

ServiceHours#

All upcoming time intervals during which Ridepooling is offered in the respective service area.

Field	Type	Description
service_hour_intervals	repeated moia.type.v1.TimeInterval	The time intervals in which Ridepooling in this service area is in service. The time intervals are ordered chronologically from the current time to the future.