GeoConverter Class

An object capable of communicating with the backend to convert between coordinates in a geographic coordinate system and coordinates in an IModelConnection's own coordinate system. Conversion results retain the backend's per-point status, including failed vertical conversions. Check each status before using elevations; GeoCoordStatus.VerticalDatumConvertError does not provide a reliable converted Z. Results, including failures, are cached in this converter. Loading grids does not invalidate those cached results. To retry after resources become available, finish outstanding requests and acquire a fresh converter from getConverter instead of reusing the retained instance.

@see - getConverter to obtain a converter.

  • GeographicCRS for more information about geographic coordinate reference systems.

Methods

Name Description
convertFromIModelCoords(iModelCoords: XYZProps[]): Promise<PointWithStatus[]> Convert the specified iModel coordinates into geographic coordinates.  
convertToIModelCoords(geoPoints: XYZProps[]): Promise<PointWithStatus[]> Convert the specified geographic coordinates into iModel coordinates.  

Defined in

Last Updated: 05 November, 2026