topic Re: Adjusting KML placement in realtime in a MapView in Qt Maps SDK Questions

Adjusting KML placement in realtime in a MapView

BrianCrist — Sun, 12 Dec 2021 15:57:43 GMT

Hi,

Background: Working in ArcGIS Runtime for QT version 100.8 in QT version 5.14 on an Ubuntu system running release 19.10.

I've got a KML GroundOverlay graphic whose position I'd like to update in real-time. The graphic is rendered just fine initially, but any subsequent calls to functions on the KmlGroundOverlay don't seem to have an effect. As an example, here's a bit of code:

Considering the variables:

Esri::ArcGISRuntime::KmlGroundOverlay * m_groundOverlay;
Esri::ArcGISRuntime::KmlDataset *m_kdata;
Esri::ArcGISRuntime::KmlLayer *m_klayer;
Esri::ArcGISRuntime::Map *m_map;

In the "before" code - before the KML is called:

m_map(new Map(Basemap::topographicVector(this), this));

Setting up the KML Ground Overlay:

const Envelope env(-.001, 0.001, .001, 0.00, SpatialReference::wgs84());
KmlIcon * kmlIcon = new KmlIcon(QUrl("/home/bcrist/hundySquare.png")); // "hundySquare.png" is a red square shaped image file
// Create Overlay
m_groundOverlay = new Esri::ArcGISRuntime::KmlGroundOverlay(env, kmlIcon, this);
// Create Dataset
m_kdata = new Esri::ArcGISRuntime::KmlDataset(m_groundOverlay, this);
 // Create Layer
m_klayer = new Esri::ArcGISRuntime::KmlLayer(m_kdata, this);

m_map->operationalLayers()->append(m_klayer);

Subsequently trying to just spin the layer around via a timer-called separate function (for testing purposes, obviously):

m_groundOverlay->setRotation(m_groundOverlay->rotation() + 1);
if (m_groundOverlay->rotation() > 360)
{
 m_groundOverlay->setRotation(0);
}

I've assembled the "EditKmlGroundOverlay" sample from the arcgis-runtime-samples-qt repo on Git and altered it do perform the rotation above, and it works fine. The only difference I can figure out is that the EditKmlGroundOverlay sample uses a scene view instead of a map view.

Is this a limitation of Map Views or am I doing something wrong or missing something?

Re: Adjusting KML placement in realtime in a MapView

LucasDanzinger — Mon, 10 Aug 2020 18:08:36 GMT

Hi Brian,

This is a limitation with GroundOverlays with the currently released software - these properties can be modified but do not show up properly in the MapView. As you noticed with the sample, everything should work as expected in the SceneView.

Re: Adjusting KML placement in realtime in a MapView

BrianCrist — Mon, 10 Aug 2020 18:20:03 GMT

Hi Lucas,

Thanks for the answer! So this sort of leads to a bigger question I suppose. Should I be leaning more towards implementing a Scene View instead of a Map View for something that is visualizing, say, vehicles whose positions are being updated regularly? I.e. are scenes generally a better idea for implementations that require a lot of real-time updating?

Regards,

Brian

Re: Adjusting KML placement in realtime in a MapView

LucasDanzinger — Mon, 10 Aug 2020 18:24:11 GMT

No, I wouldn't say that necessarily. This is just one particular bug we have in our implementation of KML.

Re: Adjusting KML placement in realtime in a MapView

BrianCrist — Mon, 10 Aug 2020 20:06:51 GMT

Thanks Lucas,

So the issue behind all of this KML that I'm trying to resolve is actually this: My application has a video stream; call it a stream of QImages coming from an sensor. The images are known to be a certain real-world size, which is also fed to my application from the sensor.

I need to render these QImages at their "real world" size on the map. I posted earlier in the year and was suggested a KmlGroundOverlay / Envelope whose size is created from those data coming from the sensor. But if real-time updates aren't going to happen on a KmlGroundOverlay in MapView, I need to come up with another solution...

The obvious seeming one to me is to use a PictureMarkerSymbol and setting an overlay's setScaleSymbols flag to true. But I rapidly run into my limits of GIS understanding when I try to do this... I end up rendering things in near-to-real-size not cannot figure out how to render them in actual-real-size on the map. I don't understand the relationship between the viewPortScale and the map's referenceScale and how to set these values to be able to, say, make a 100m x 100m square.

Is there a way to make a PictureFillSymbol do its thing without tiling the source image?

Any suggestions on working around the KML updates would be greatly appreciated.

Re: Adjusting KML placement in realtime in a MapView

LucasDanzinger — Mon, 10 Aug 2020 20:29:07 GMT

I see. Since that solution was discussed, we released a newer API designed for a very similar use case you are mentioning. It is for the ImageOverlay, which was designed to take real time images from radar/sensors and display rapidly. This currently only works in 3D since that was the initial requirement, but we are aiming to bring this to 2D at some point. Can you try out this sample? You'll need to change the .pro file's runtime version to 100.8, as this is part of our development branch currently (v.next branch) - arcgis-runtime-samples-qt/ArcGISRuntimeSDKQt_CppSamples/Scenes/AnimateImagesWithImageOverlay at v.next · Esri/arcgis-run…

Re: Adjusting KML placement in realtime in a MapView

BrianCrist — Mon, 10 Aug 2020 20:54:03 GMT

Hi Lucas,

Yes that built fine with 100.8, but I could not find the animation (3D/ImageOverlay/PacificSouthWest) - is it someone online for download?

And the key is that we're on a Map/MapGraphicsView and would prefer not to go to a Scene View for a few reasons. But the ImageOverlay would be absolutely perfect for what we're trying to accomplish (if it worked in a Map/MapGraphicsView!)

Regards,

Brian

Re: Adjusting KML placement in realtime in a MapView

LucasDanzinger — Mon, 10 Aug 2020 20:58:28 GMT

Here is the data - https://www.arcgis.com/home/item.html?id=9465e8c02b294c69bdb42de056a23ab1

If possible, could you email me some details about your org, project, requirements, etc? That would help gain justification for getting this running in 2D - ldanzinger@esri.com

Re: Adjusting KML placement in realtime in a MapView

BrianCrist — Mon, 10 Aug 2020 21:06:27 GMT

Thank you for the data, it looks awesome.

I will email you more details about the project and organization. Thanks so much for all of your help.

I'm on the East Coast, so I'll probably email first thing in the morning (8/11/20)

Re: Adjusting KML placement in realtime in a MapView

BrianCrist — Fri, 14 Aug 2020 14:14:20 GMT

Hi Lucas,

I emailed on Tuesday morning and never heard back. Please advise on the status; did you receive my email? Any ideas?

Regards,

Brian

Re: Adjusting KML placement in realtime in a MapView

LucasDanzinger — Fri, 14 Aug 2020 14:55:28 GMT

Hey Brian-

Thanks for your email. We are wrapping up 100.9 release right now, so it is a bit hectic.

I passed your information onto our senior product managers for their consideration. Hopefully we can either get the KML Ground Overlay 2D issue fixed or Image Overlay in 2D implemented, but that timeline is unknown. What I do know is 100.9 is going to be released in a week or so, but neither of these will be in that release.

For the time being, would it be an option to use 3D instead of 2D and orient the camera in a top down manner so it looks 2D?

Re: Adjusting KML placement in realtime in a MapView

BrianCrist — Fri, 14 Aug 2020 15:56:58 GMT

Hi Lucas,

I initially thought doing a "top-down" 3-d look would be the best option, but we need to display grid lines; the program manager has indicated losing grid-lines is a non-starter.

The work-around I'm using feels very clumsy, but maybe it's the best I can do:

I can produce an envelope that is accurately sized that contains the sensor data I'm interested in displaying.
If I could find a way to know the dimensions of this envelope in pixels, I could scale the QImage via QImage::scaled() to produce a corrected-sized image.
I'm setting the sensor data's graphic overlay setScaleSymbols flag to True
I have a sort of kludgey version of pixels-to-meters done by doing a GeometryEngine::DistanceGeodetic between two points in the middle of the MapView...
- I'm running into issues with this because I don't understand how Map scaling and GraphicsView scaling relate to one-another; in other words, if the scale on the Map View viewpoint's center is the same as the Map's referenceScale everything is hunky dory. But if I change the zoom level on the Map View, my crappy pixels-to-meters calculation does not work properly.
If I had an accurate way to get pixels to meters; or if I understood what the heck I was doing with this scaling, I think I could resolve this problem and pour myself a nice glass of champagne.

Regards,

Brian

Re: Adjusting KML placement in realtime in a MapView

LucasDanzinger — Tue, 18 Aug 2020 17:55:30 GMT

Hi Brian-

Maybe MapView::unitsPerDIP could get you what you need - https://developersdev.arcgis.com/qt/latest/cpp/api-reference/esri-arcgisruntime-mapview.html#unitsPerDIP

We added this API so users could build a scalebar, which conceptually is very similar to the need you have - to tell how many real-world units are in one device independent pixel. Real-world units will be in whatever the 0th layer in the map is, so if you are using web mercator basemap, it will be meters.

Re: Adjusting KML placement in realtime in a MapView

BrianCrist — Tue, 18 Aug 2020 19:46:26 GMT

Hi Lucas,

This is where my ignorance of GIS comes into play. So the map I'm using is a Basemap::TopographicVector and the mapView's spatial reference is WKID 3857, who's unit is a meter.

When I use unitsPerDip (which I tried quite a while ago when I was first wrestling with this) - when I render my 100 meter square at 0,0 everything is great. But when I render it in Vermont (-72.9927854, 44.4050029 in spatial reference Wkid 4326), the size is reduced.

I understand this has to do with the projection somehow, but I do not understand how.

I came up with a pretty hacky way to solve this which seems to be working:

When the zoom level changes, I obtain Points from two adjoining pixels in the middle of the mapView using screenToLocation and using the GeometryEngine to calculate the meters between these two points. This gives me a "pixels to meters" which seems to calculate the size of my 100x100 square pretty accurately wherever it is in the world.

I then divide that value by the ratio of the mapView's scale to the Map's scale.

However, I think this is probably a little more resource intensive than it should be, and it definitely feels like a hack. Is there any way you can either email me or clarify on this thread how I take the UnitsPerDip and project them properly at various latitudes?

Thanks so much,

Brian

Re: Adjusting KML placement in realtime in a MapView

BrianCrist — Tue, 18 Aug 2020 20:27:22 GMT

It's probably important to note that I'm using an overlay whose setScaleSymbols flag is set to true also. I think that's an important element to my code above functioning properly.