Geolocate OGC 3D Tiles

This sample shows you how to geolocate an OGC 3D Tiles dataset on the globe. The prerequisite for this is that the sample dataset is not already georeferenced. In the case of an OGC 3D Tiles, this means that its metadata does not use the Region element, but instead a Box without a root level transform.

When an OGC 3D Tiles dataset is not georeferenced, its reference will be "LUCIAD:XYZ", which is a cartesian reference that does not contain geospatial information. The "LUCIAD:XYZ" reference does however say something about its axes: All axes are expressed in meters, and are pointing in specific directions:

• X-axis: East
• Y-axis: North
• Z-axis: Up

With this basic sense of direction, it is possible to geolocate and orient the dataset as needed, using the GeoLocateController

Internally, the GeoLocateController creates an Affine3DTransformation , which is a transformation that can convert the "LUCIAD:XYZ" reference into a geospatial reference "EPSG:4978", an earth-centered, earth-fixed geocentric reference.

Usage

• Click and drag the building icon onto the map. This will generate a new layer at the position of the mouse.
• When active, you can drag around the building by hovering over it and dragging the base plane around.
• When active, drag around the outer circle of the building to change its orientation.
• To move the building up and down, look at it from its side, and drag the vertical controls up and down.
• To slice the building, or to scale the terrain displacement, click on the Slice button (or press space) and drag the corresponding handles.
• Click on the fitting buttons in the corner of the map to move the camera to convenient geolocating angles.
• Press CTRL+Z and CTRL+Y to undo and redo changes to the geolocation. On Mac machines, you can also use CMD+Z to undo and CMD+SHIFT+Z to redo.

Data

Background data

There are two datasets you can choose from as background data in this sample.

• By default, the sample works with The Marseille 3D mesh data, created by Airbus with Airbus Street Factory and hosted by our LuciadFusion server on https://sampleservices.luciad.com/.
• You can also use Google 3D tiles as background data. To accomplish that, provide your own Google API key in the URL of the sample as &googleAPIKey=...YOUR_API_KEY...

Houses

The non-geospatial dataset of the buildings were created by Somnit and ztrztr on http://www.sketchfab.com and also hosted by our LuciadFusion server on https://sampleservices.luciad.com/. You can use these services only for simple tests and demonstrations. You should not rely on either of them in any way.