GeoJSON Converter Extension¶
Overview¶
The NVIDIA Omniverse™ GeoJSON Converter Extension parses geospatial data stored in GeoJSON files and visualizes them in Omniverse™.
Features¶
Parses GeoJSON (.geojson) files and converts the data into prims on a USD stage
UI window provides a field for the user to define a file location containing the GeoJSON file(s) and a checkbox to toggle for recursively checking for GeoJSON files from user-defined file location
Note
The tool is currently able to convert data following the WGS84 coordinate system
Parsing and Converting GeoJSON Data¶
This tutorial provides the steps to generate map tiles as meshes in Omniverse USD Composer. The OGC Map Tile Loader extension is not enabled by default in Create and will need to be enabled for use.
Open Omniverse USD Composer.
Navigate to Window > Extensions.
Search for and enable the GeoJSON Converter Extension.
Navigate to Window > GeoJSON Converter (beta) to open the extension window.
Click on the GeoJSON Converter (Beta) tab.
The window is contains a collapsible window for settings for the extension. Below is a description of each field.
Fields |
Description |
|---|---|
File location(s) |
(string) starting directory path containing GeoJSON file(s)
|
Recursively check for GeoJSON files? |
(checkbox) when set to True, extension will recursively check for GeoJSON files starting at this directory; otherwise, parse GeoJSON files at this directory
|
In the “Settings” collapsible window, for the “File location(s)” field add the absolute path for the folder you wish to parse GeoJSON data from.
Note
Providing a relative path will causes errors. Some paths may be invalid due to user read-write permissions and whether the folder exists.
In the “Settings” collapsible window, select or deselect the “Recursively check for GeoJSON files?” checkbox in order to recursively traverse through folders starting from the defined directory or only parse the files at the defined directory.
When inputs have been provided and ready, click on the Convert GeoJSON File(s) button.
Note
The conversion may take some time to load.
Verify your feature(s) has/have been created in the stage by navigating to the Stage tab, clicking on the Geospatial prim, and hitting the F-key to focus on the desired feature.
Note
You may not be able to see the feature, so try to zoom in and out. To help with rendering, follow the following steps.
(Optional) In your viewport, select the Perspective camera and select the three-slider icon to the right of Perspective.
(Optional) In the Properties tab, increase the far clipping range value. You can multiply the value by inserting a zero (0) before the decimal (.) point (i.e., “100000000.0” becomes “1000000000.0”).
