SIRI-VM Subscription Request Topic Info: VehicleMonitoringRef

[MGGomes]

Hello everyone!

Help needed from any of you SIRI gurus out there.

Context: SIRI Vehicle Monitoring Subscrition Request, Topic information

Problem: I'm strugggling to really understand what VehicleMonitoringRef really means...

Everything is clear about VehicleRef, LineRef or DirectionRef (pre-defined reference information as per the Operator/Authority).

In one way or the other they are present in some of the other subscription requests.

These are just fine.

As per VehicleMonitoringRef, it is documented in the xsd as being "A predefined scope for making VEHICLE requests.".

What does this mean? A predefined group of vehicles? A predefined group of vehicles on some given line(s) travelling to some given direction?

What's the scope's scope, so to speak? 

Adding insult to injury, one of the examples given surprisingly adds a <DestinationRef> element to the topic info.

(...)

<!--=======TOPIC ===================================== -->

<VehicleMonitoringRef>VIS123</VehicleMonitoringRef>

<DestinationRef>Place875</DestinationRef>

<VehicleMonitoringDetailLevel>minimum</VehicleMonitoringDetailLevel>

(...)

Where does this <DestinationRef> come from?

Unless I'm mistaken (it happens more often than I'd like to admit...) It is NOT included in the xsd file, in the VehicleMonitoringTopicGroup.

To end with a smaller issue: according to the xsd I believe it is possible to send a VehicleMonitoringSubscriptionRequest with no topic information whatsoever (meaning: do not filter the results, give me everything you have!).

Am I correct, here?

I'd be really grateful if someone could shed some light on this.

Thanks!

All the best,

Miguel

[Sean Barbeau]

Miguel,

I'd suggest taking a look at MTA NYC's Bus Time API documentation, which explains how they are using SIRI VehicleMonitoring:

https://bustime.mta.info/wiki/Developers/SIRIVehicleMonitoring

tl;dr - the scope is defined by the parameters you send to the server - it can be one, some, or all vehicles. So if you include <VehicleRef>, you'll get information about just that vehicle ID. If you include just <OperatorRef>, it will be for all vehicles for that operator.

I'm not sure on <DestinationRef> - is that maybe corresponding to headsign? I don't believe MTA NYC supports this.

And yes, I believe if you don't provide any of the optional parameters, you'll get a dump of all operating vehicles.

Sean

Sean Barbeau

Center for Urban Transportation Research

University of South Florida

[Miguel Gentil Gomes]

Thanks, Sean!

I'll definitely take a look at that information.

Best regards,

Miguel

--
You received this message because you are subscribed to a topic in the Google Groups "SIRI Developers" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/siri-developers/n0sY9fJPTjE/unsubscribe.
To unsubscribe from this group and all its topics, send an email to siri-develope...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/siri-developers/3733d989-d743-46d2-bf30-5a2f789c5c62n%40googlegroups.com.