GeolocationExtension
Provides functions for converting GPS coordinates in WGS-84 format { x: Longitude, y: Latitude, z: Height(m) } into
Viewer scene coordinates, and back. Supports a single model loaded into the scene.
The extension id is: Autodesk.Geolocation
new GeolocationExtension(viewer, options)
Parameters
| viewer* Autodesk.Viewing.Viewer3D | The Viewer instance |
| options Object | Not used |
Examples
viewer.loadExtension('Autodesk.Geolocation')
Methods
activate(mode)
When active, the extension will detect clicks on the model and will place a marker on the model. A panel will be displayed containing vertices clicked on the model. Each point-entry will also contain GPS its associated GPS position.
Parameters
| mode string | The activation mode |
deactivate()
Stops detecting click events on the canvas and closes the Panel.
isActive()
Whether the extension is active. When the extension is active, click events will be processed and added into a Panel.
Returns
| type | description |
|---|---|
| boolean | True if the extension is active. |
hasGeolocationData()
Returns
| type | description |
|---|---|
| boolean | true when the model contains geolocation data. |
lmvToLonLat(lmvPoint)
Converts viewer coordinates (obtained with something like viewer.clientToWorld())
into { x: Longitude, y: Latitude, z: Height (meters) } in WGS-84 format.
Parameters
| lmvPoint* THREE.Vector3 | 3D point in the scene |
Returns
| type | description |
|---|---|
| THREE.Vector3 | GPS coordinate in WGS-84 format: { x: Longitude, y: Latitude, z: Height } |
lonLatToLmv(lonLat)
Converts coordinates from { x: Longitude, y: Latitude, z: Height (meters) } in WGS-84 format into viewer scene coordinates.
Parameters
| lonLat* THREE.Vector3 | GPS coordinate in WGS-84 format: { x: Longitude, y: Latitude, z: Height } |
Returns
| type | description |
|---|---|
| THREE.Vector3 | 3D point in the scene |
openGoogleMaps(pointLL84)
Returns a Google Maps URL with a PIN on the specified GPS location. When no argument is provided, the URL will use the Model’s geolocation if available.
Parameters
| pointLL84 THREE.Vector3 | GPS location in WGS-84 format: { x: Longitude, y: Latitude }. Height is ignored. |
getCurrentPositionLmv()
Returns a Promise that resolves with a position in Viewer-space coordinates based on the device’s real world GPS position.
Returns
| type | description |
|---|---|
| Promise | that resolves with a THREE.Vector3 containing Viewer-space coordinates. It rejects if device’s real world GPS position is not available. |
