@inovitas/infra3dapi NPM

Installation

NPM Package

The API can be installed as a package using npm. To install it from the npm package repository, simply type:

npm install @inovitas/infra3dapi

CDN Download

Alternatively, you can obtain the API from a CDN. To get the latest version, add the following script to your HTML file:

<script src="https://cdn.jsdelivr.net/npm/@inovitas/infra3dapi@latest/infra3dapi.js"></script>

We recommend using a specific version in your project. To get a specific version, use the following script and adjust the version accordingly:

<script src="https://cdn.jsdelivr.net/npm/@inovitas/infra3dapi@1.0.1/infra3dapi.js"></script>

Note: Please do not name the <div> in which the viewer is initialized as "infra3d" as this may cause internal conflicts.

Core Concept

To use the API, you can call the init functions in infra3dapi. After loggin in and initializing the view (with manager.initView()), you will get a viewer object. This viewer object can then be used to add event-listeners to different events emitted by the viewer (like viewer.geoframechanged) or to call some functions (like viewer.getRoutes() or viewer.movePosition()).

Authentication

Register your OAuth 2.0 application with our sales team to obtain credentials (client_id and client_secret).
Develop a server-side component to securely use these credentials, obtaining an access token from infra3D.
Your server-side component fetches the access token using client credentials, which can then be shared with your client app.
Your client app uses this token to authenticate with infra3D for requested services, refreshing it via the server component when expired. Remember to treat the client_secret like a password, avoiding exposure in client-side environments for enhanced security.

Changelog

1.2.4 - 12.06.2025

Bugfixes

Some request when using a non-migrated user resulted in a 400 Bad Request.

1.2.3 - 05.06.2025

Bugfixes

Profile Tool enlarge button now has a tooltip
Add-On Point Cloud Export: Authorisation based on scope entry in token

Added

LoD Concept for Pointcloud fragments
Add-On Point Cloud Export: Loading state on startup

1.2.2 - 17.04.2025

Bugfixes

Keydown/-up Eventlisteners ignored if evt.target is an HTMLInputElement, HTMLTextAreaElement or HTMLSelectElement.
Requests in routesprovider have a lower limit to not reach the backend limit of 6 MB.
Viewer is destroyed completly, with unlistening to events.
Layer-configs: Wrong handling with source_options fixed
When adding a new feature, it could be saved only after two inserts. This is now fixed.
Fix shortened arcgis URL in Layer options
Fix jump to multipolygon feature in Feature table
Fix bug when Frame 0 is not inside projectscope
Fix zick-zack bug in map when having lra-projects

1.2.1 - 24.02.2025

Bugfixes

React Reference Error when activating survey wheel measurement
Not loading depthmaps anymore if loading view

1.2.0 - 16.12.2024

Bugfixes

Improve styling when using global box-sizing style
Style of the scrollbar is no more globally overwritten by the API
Resize event listens now on the div and not the whole window

Added

Added functions on viewer to draw and pick a geometry
Added geometry overlays to display geometries in the viewer
Function to destroy the API and remove it from the DOM

1.1.2 - 21.10.2024

Bugfixes

viewer.getRoutes() resulted in an error

1.1.1 - 14.10.2024

Bugfixes

Layer export not working for non-memory layers
Duplicate layers when exporting directly after importing layers (without reloading)

1.1.0 - 09.10.2024

Bugfixes

Bug in viewer.getRoutesOutline() when using as migrated user.
Same default EPSG-Code (4326) when using start-position for (un)-migrated users.

Added

ProjectScope is available to restrict the access inside a project accordingly.
New concept for routes abstraction in the map, using hexagons
viewer.getRouteLines() and viewer.getRouteHexes()
PointCloudExport
Support of EPSG-Code in start-position

1.0.3 - 17.09.2024

Bugfixes

Fixed pilegate URL for migrated users.
Using the profiletool, added an information and reset the tool when changing the image while performing a measurement.
Fix the bug when using jest for testing.
Added missing bounding box parameter to viewer.getRoutes().

1.0.2 - 06.08.2024

Bugfixes

Fixed bug in the layer tree view. The layer tree is visible again.

1.0.1 - 23.07.2024

Bugfixes

Fixed a bug in the campaign change event in the viewer.

1.0.0 - 17.05.2024

Bugfixes

Restoration of toolbar and top bar functionality: They can now be shown and hidden smoothly.

Added

Introduction of machine authentication and a new corresponding example.
- Added: Option for access token in the init function.
- Added: Refresh token for the init function.
Typings