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 in Create 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 Create. The OGC Map Tile Loader extension is not enabled by default in Create and will need to be enabled for use.

  1. Open NVIDIA Omniverse™ Create.

../_images/open-geospatial-consortium-extension_image_extension-window.png
  1. Navigate to Window > Extensions.

../_images/OGC-Ext_0_Open_Window_For_Ext.png
  1. Search for and enable the GeoJSON Converter Extension.

../_images/Geojson-Ext_1_Search_for_geojson.png
  1. Navigate to Window > GeoJSON Converter (beta) to open the extension window.

../_images/Geojson-Ext_2_Select_extension.png
  1. Click on the GeoJSON Converter (Beta) tab.

../_images/Geojson-Ext_3_Geojson_ext_startup.png

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
  1. 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.

../_images/Geojson-Ext_4_Filled_url.png

Note

Providing a relative path will causes errors. Some paths may be invalid due to user read-write permissions and whether the folder exists.

  1. 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.

  2. When inputs have been provided and ready, click on the Convert GeoJSON File(s) button.

Note

The conversion may take some time to load.

  1. 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.

../_images/Geojson-Ext_5_Generated_output_hierarchy.png ../_images/Geojson-Ext_6_Generated_output_stage.png

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.

  1. (Optional) In your viewport, select the Perspective camera and select the three-slider icon to the right of Perspective.

../_images/OGC-Ext_16_perspective_camera.png
  1. (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”).

../_images/OGC-Ext_15_increase_far_clipping_range_add_0.png

Release Notes

1.0.3

  • Extension beta release for Create 2022.3

Known issues

Rendering Issues

  • Polygons: triangulation of non-flat meshes may cause unexpected shadows due to calculation of normals