plane icon Welcome to Microsoft Flight Simulator’s SDK Q&A Platform!

You have questions regarding the SDK? DevMode Tools? SimConnect? You would like to submit an idea for future improvements, seek help or exchange knowledge? You’re in the right place.


Please take a moment to read the platform’s guidelines before you get started!


Idea

virtuali avatar image
virtuali suggested Arzop commented

SimConnect_AddToFacilityDefinition missing definitions for Jetways

There are some data missing from the JETWAY data definition:

Jetway name

Jetway position ( Lat/Lon Bias from airport center )

Jetway heading


A data definition for a JETWAY_LINK is also missing entirely, and should include:

Link GUID

Link Position

Link Heading


simconnect
10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

10 Comments

·
virtuali avatar image
virtuali commented

Would like to have a comment about this. We would like to support the new API as soon it's out, but missing data about Jetways and Jetway links are really a problem.

10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

virtuali avatar image
virtuali commented

It's very nice you confirmed Runway Starts will be added, but for us Jetway (and Jetway Links) are far more important: we need to let passengers walk through them and right now it's not possible if the airport has been bought on the Marketplace.

10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

virtuali avatar image
virtuali commented

Another possible way out of this, lacking a proper support in the API (which would be preferred), might be at least giving Jetways a separate Category, like for Boats, Humans, Animals, at least we could search for them.

Right now, they are returned as StaticObjects and only by setting the search radius to 20001 meters (has this issue being fixed ?), so a very convoluted way we tried to use to know which ones are jetways, is try to read the hood variables on every single StaticObject found in the scenery, and get the ones that don't return an exception. This was just during a test, I wouldn't want to use that method in a real product, but if Jetway data is missing from the Facilities API, I don't see any other ways which could work with Marketplace airports as well standard DRM-free airports.

10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

moonbst1 avatar image
moonbst1 commented

Please include Jetway data as above listed.

10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

virtuali avatar image
virtuali commented

Would be nice to have some confirmation if this feature is at least taken into consideration, because right now the only data about jetways in the new APIs is knowing if a parking has a jetway or not.

While is still useful, it's not enough to make the API really usable, without knowing the jetway position.

And, searching for jetways around the user is hampered by the other bug of not getting all objects (including, but not only, jetways) unless the search radius is set to 20001 meters or more.

And if we really need to search for Jetways, we should have at least have a separate Category for Jetways because right now, they are returned mixed with other objects so, the only way to be sure a found SimObject it's a Jetway, is to try reading the Jetway-specific variables (over possibly 100+ of objects, because of the 20001 meters bug) and catch all exceptions, hardly an efficient or safe way of doing things.

And since there's no way to search for Jetway Links, since they are not SimObjects, those should be probably added to the Facilities definitions as well, since they are usually an integral part of the Jetway.

10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

MaxHype avatar image
MaxHype commented

It would be very useful to have at least the jetway position

10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

EPellissier avatar image
EPellissier commented

@virtuali,

We had a look at this when you first posted and forgot to reply - apologies for this.

The data you are requesting is not as easily accessible as other parts we already return. We'll get back to this and see if/how additional information could be provided.

Best regards,

Eric / Asobo

10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

virtuali avatar image
virtuali commented virtuali edited

@EPellissier , it would be very useful it you found a way to know where jetways ( and possibly jetway links ) are.

We noticed another issue, which makes finding Jetways and associated them to a gate even more difficult: it seems that reading/writing Jetway-specific Simvars works with every StaticObject, regardless if it's a Jetway or not. We hoped to use managed data error exceptions to find Jetways that way, but it can't, since every StaticObject accepts reading and even writing Jetway variables, so we don't have any other way than using some heuristic based on their names. And even in that case, their association with a parking position is not very reliable, since we would need to use another heuristic, like assuming jetways are usually placed on the top-left area of the parking radius, which is not very reliable at all.

It we had the Jetway position from the Navdata API, we could just compare its position with the position of the found Simobject in the scene, and be fairly accurate detecting that object as a Jetway.

Some things or alternatives that might help as well:

- Giving Jetways a dedicated Category, one that can possibly passed as a filter to the RequestDataOnSimObjectType call.

Right now, StaticObjects don't have their own SIMCONNECT_SIMOBJECT_TYPE enum, which is another problem, that force searching with SIMCONNECT_SIMOBJECT_TYPE_ALL, reading the Category SimVar and make another pass to exclude things that are not StaticObjects ), if Jetways had their own separate category and a SIMOBJECT_TYPE_JETWAY, the search would be easier and would generate less traffic on Simconnect.

- Fix the bug that requires to set at 20001 meters search range for Jetways to be included in the returned objects, please. This increases Simconnect traffic for no reason, since we need to use that large range, even if we only need to find the Jetway closest to the user.

- Add some SimVars to the Jetway objects indicating their associated parking spot, like the Parking Name, Number and Suffix. This could be used as an alternative to getting the data from the NavData API: once we know a particular parking spots has a Jetway, we could query the SimObjects in the scene until we find the one with SimVars set to match the parking. If this could be added to the previous two points, finding the Jetway closest to the user should be very quick.

But the most important thing missing from Jetways in general is still this one:

- There's not way to know IF and WHERE a Jetway has Docked. We have the Hood variables, which are useful to a point, to at least figure it out a Jetway docked ( if it's not moving and any of the hood variables are not zero, it should have docked ), but the problem is, it doesn't help knowing where it has docked, or if it docked partially because it couldn't reach the door.

This could be fixed if we had some extra SimVars for the Jetway object to report the actual position of the bone associated to the IK_SecondaryHandle, possibly expressed as XYZ offset from the Jetway reference point. This would allow us to know where the jetway end is at the end of the animation.

10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

Darwikey avatar image
Darwikey commented virtuali edited

Hi @virtuali @MaxHype,

Actually if I'm not wrong, you can already retrieve jetway position by looking for the corresponding parking and it has the bias information. You have to compare parking name, suffix and number to jetway members "parking_gate" "parking_suffix" and "parking_spot" respectively (the naming is not great here...)

Regards,
Xavier

2 comments
10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

virtuali avatar image virtuali commented ·

Hi @Darwikey ,

We already using the fields in the Jetway data to know the parking the Jetway is associated to, but that only tells us that parking spot has a jetway, not where it is or how it's oriented.

Just knowing if a parking spot has a jetway is not really useful without its position, and searching for it by looking at all Simobjects in the scene has many issues:

- Because of the "20001 meters bug", we need to search for Simobjects in a > 20000 meters range around the user, otherwise Jetways won't be returned in the search, causing unnecessary traffic over Simconnect, since with 20k meters, we often get lots of objects even from nearby airports in some areas.

- Because Jetways don't have a dedicated Category, like Humans, Animals, Boats do, the above search must be made for ALL Simobject types.

- Because every Static Object respond to read/write Jetway-specific SimVars with no errors, we can't use a strategy of trying to read/write to such variables and intercepting Exceptions in order to recognize which, of the many Static Objects are Jetways, so we need to use some heuristic based on their Title and their proximity to the user airplane.

- Because some airports have double Jetways at gates, one inserted as a "proper" Jetway associated to the TaxiwayParking and a secondary not animated one ( but with the same Title ) inserted as a SimObject outside the parking hierarchy, there's no way for us to know which one of the two is the "real" Jetway that will eventually move, and which one is the secondary/static one, since they are both named as Jetways and are both close to the user.


This would work so much better if API could be improved in the following way:

1) The Jetway member in Navdata included a "Bias" field like the TaxiwayParking, and possibly PBH insertion parameters as well, so we know exactly where that jetway is.


2) Jetways should have their separate "Jetway" Category, and we could call RequestDataOnSimObjectType passing a new SIMCONNECT_SIMOBJECT_TYPE enum possibly named SIMCONNECT_SIMOBJECT_TYPE_JETWAY.

It would be best if only Jetways associated to a Parking spot would be returned this way, while static Jetways placed as SimObjects outside a Parking spot should keep their Category as "StaticObject", because that's what they really are.


This way, having the Jetway position in the Navdata API, we could compare it with the Jetway position in the scene, to finally get the Simobject ID, which we can then query to know about the Jetway status.


It goes without saying that, once we have the Jetway Simobject itself, it would be really useful to have extra SimVars added to it, indicating:

- A flag telling if the jetway is docked or not, similar to JETWAY MOVING, but indicating the docked/undocked status

- Variables similar to the Hood or Wheels, indicating the position of the IK_SecondaryHandle as XYZ Bias from either the Jetway root or the airport, so we could know for sure which door the Jetway has docked, or if has docked partially, or not at all.

1 Like 1 ·
MaxHype avatar image MaxHype commented ·
OK but at the moment you have only the corresponding parking bias information, not the jetway bias
0 Likes 0 ·
virtuali avatar image
virtuali commented

Would be possible to get some answer if the BIAS for the Jetway object itself would be added to the Navdata API ?

It's really important for us, to get the actual Simobject in the scene associated to each parking, and searching by name using some heuristic is not efficient ( we need to ask for *all* Simobjects in the scene ), and it's not reliable either, because sometimes the jetway closest to the parking center is not the one associated to it, and some sceneries have double jetways, the working one inserted as a proper Jetway, and a static one as a Simobject with the same title, but not associated to a parking, so it's basically impossible to know which one is the real one.


10 |10000

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

Write a Comment

Up to 5 attachments (including images) can be used with a maximum of 4.8 MiB each and 23.8 MiB total.

Your Opinion Counts

Share your great idea, or help out by voting for other people's ideas.