@navaramap/three-api 0.0.8 → 0.1.0

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2026 MapLibre contributors
+Copyright (c) 2026 Navara contributors
 
 This project is dual-licensed under either of
 

package/README.md

@@ -1,3 +1,32 @@
 # @navaramap/three-api
 
-This is a api module for Navara for Web platform.
+Standalone geodetic and GIS math for Three.js, powered by Navara's WASM core. It covers geodetic ⇔ ECEF conversion, WGS84 ellipsoid constants and surface normals, local tangent frames (ENU/NED/NUE/NWU/WUN and heading/pitch/roll placement), screen ⇔ world projection and pick rays, ray/plane intersection, ellipsoid geodesics, and RTE (relative-to-eye) encoding for jitter-free rendering far from the origin. Everything is integrated with the Three.js type system (`Vector3`, `Matrix4`, cameras).
+
+Unlike the rest of the Navara stack, this package is usable without the map engine: it is the standalone form of Navara's API tier, for pure geometry computation in any Three.js app.
+
+## Usage
+
+Initialize the WASM module once before calling anything else (when using `@navaramap/three`, `view.init()` does this for you):
+
+```typescript
+import { initNavaraApi, geodeticToVector3 } from "@navaramap/three-api";
+
+await initNavaraApi();
+
+// Geodetic coordinates (degrees, meters) to ECEF Cartesian.
+const position = geodeticToVector3({
+  lng: 139.77,
+  lat: 35.68,
+  height: 0,
+});
+```
+
+All of these utilities are also re-exported by `@navaramap/three`, so applications using the map engine don't need a direct dependency on this package.
+
+## Documentation
+
+Every function is documented at https://navara-docs.reearth.workers.dev/.
+
+## License
+
+MIT OR Apache-2.0

package/dist/ellipsoidGeodesic.d.ts

@@ -3,11 +3,13 @@ import { LatLngHeight } from '@navaramap/core';
  * Wrapper class for geodesic calculations on an ellipsoid surface.
  * Precomputes common variables for optimization when instantiated.
  *
+ * All latitudes/longitudes and headings are in **degrees**.
+ *
  * @example
  * ```typescript
  * const geodesic = new EllipsoidGeodesic(
- *   { lat: 0.5, lng: 2.0, height: 0 },
- *   { lat: 0.6, lng: 2.1, height: 0 }
+ *   { lat: 35.6812, lng: 139.7671, height: 0 },
+ *   { lat: 34.7025, lng: 135.4959, height: 0 }
  * );
  *
  * console.log(geodesic.distance);
@@ -21,8 +23,8 @@ export declare class EllipsoidGeodesic {
     private _raw;
     /**
      * Create a new geodesic between two points on the ellipsoid.
-     * @param start - Start point in geodetic coordinates (lat/lng in radians)
-     * @param end - End point in geodetic coordinates (lat/lng in radians)
+     * @param start - Start point in geodetic coordinates (lat/lng in degrees)
+     * @param end - End point in geodetic coordinates (lat/lng in degrees)
      */
     constructor(start: LatLngHeight, end: LatLngHeight);
     /** Distance in meters between start and end points */
@@ -34,24 +36,24 @@ export declare class EllipsoidGeodesic {
      * unreliable solution.
      */
     get converged(): boolean;
-    /** Heading at the start point in radians */
+    /** Heading at the start point in degrees */
     get startHeading(): number;
-    /** Heading at the end point in radians */
+    /** Heading at the end point in degrees */
     get endHeading(): number;
-    /** Start point in geodetic coordinates */
+    /** Start point in geodetic coordinates (lat/lng in degrees) */
     get start(): LatLngHeight;
-    /** End point in geodetic coordinates */
+    /** End point in geodetic coordinates (lat/lng in degrees) */
     get end(): LatLngHeight;
     /**
      * Interpolate points along the geodesic path.
      * @param granularity - Distance between interpolated points in meters (optional)
-     * @returns Array of interpolated points in geodetic coordinates
+     * @returns Array of interpolated points in geodetic coordinates (lat/lng in degrees)
      */
     interpolatePoints(granularity?: number): LatLngHeight[];
     /**
      * Interpolate a point at a specific distance along the geodesic path.
      * @param distance - Distance from start point in meters
-     * @returns Interpolated point in geodetic coordinates
+     * @returns Interpolated point in geodetic coordinates (lat/lng in degrees)
      */
     interpolateDistance(distance: number): LatLngHeight;
     /**

package/dist/index.d.ts

@@ -13,14 +13,14 @@ export * from './ellipsoidGeodesic';
 export declare function initNavaraApi(): Promise<void>;
 /**
  * Converts geodetic coordinates (longitude, latitude, height) to a Cartesian Vector3 in ECEF coordinates.
- * @param lle - Geodetic coordinates (lng in radians, lat in radians, height in meters)
+ * @param lle - Geodetic coordinates (lng in degrees, lat in degrees, height in meters)
  * @returns Cartesian Vector3 in Earth-Centered Earth-Fixed (ECEF) coordinates
  */
 export declare function geodeticToVector3(lle: LatLngHeight): Vector3;
 /**
  * Converts a Cartesian Vector3 in ECEF coordinates to geodetic coordinates.
  * @param xyz - Cartesian Vector3 in Earth-Centered Earth-Fixed (ECEF) coordinates
- * @returns Geodetic coordinates (lng in radians, lat in radians, height in meters)
+ * @returns Geodetic coordinates (lng in degrees, lat in degrees, height in meters)
  */
 export declare function vector3ToGeodetic(xyz: Vector3): LatLngHeight;
 /**
@@ -45,7 +45,7 @@ export declare function radianToDegree(radian: number): number;
 export declare function convertScreenToWorld(windowObject: WindowObject, camera: PerspectiveCamera, vec2: Vector2): Vector3 | undefined;
 /**
  * Computes the surface normal vector at a geodetic position on the WGS84 ellipsoid.
- * @param lle - Geodetic coordinates (lng in radians, lat in radians, height in meters)
+ * @param lle - Geodetic coordinates (lng in degrees, lat in degrees, height in meters)
  * @returns Unit normal vector pointing outward from the ellipsoid surface
  */
 export declare function geodeticSurfaceNormal(lle: LatLngHeight): Vector3;
@@ -97,7 +97,6 @@ export declare function westUpNorthToFixedFrame(origin: Vector3): Matrix4;
  * engines differ in which axis they treat as an asset's front, so a model
  * ported from one may need a multiple of 90° added to its heading.
  *
- * NOTE: unlike {@link geodeticToVector3} and the other helpers in this module,
  * `lng`/`lat` and all angles here are in **degrees**, matching
  * `setCamera` and the `geodetic` mesh Descriptor field.
  *

package/dist/index.js

@@ -1,56 +1,56 @@
-import e, { CameraFrustum as t, EllipsoidGeodesic as n, LLE as r, Ray as i, Transform as a, Vec2 as o, Vec3 as s, Window as c, angleToDegree as l, angleToRadian as u, eastNorthUpToFixedFrame as d, encodePosition as f, geodeticSurfaceNormal as p, geodeticToXyz as m, getHeightFromEllipsoid as h, getPickRay as g, getPlaneFromPointNormal as _, getRayPlaneIntersection as v, getWGS84Eccentricity as y, getWGS84EccentricitySquared as b, getWGS84Flattening as x, getWGS84SemiMajorAxis as ee, getWGS84SemiMinorAxis as te, northEastDownToFixedFrame as ne, northUpEastToFixedFrame as S, northWestUpToFixedFrame as C, screenToWorld as w, worldToScreen as T, xyzToGeodetic as E } from "@navaramap/engine-api";
-import { Euler as D, MathUtils as O, Matrix4 as k, Plane as A, Ray as j, Vector2 as M, Vector3 as N } from "three";
+import e, { CameraFrustum as t, EllipsoidGeodesic as n, LLE as r, Ray as i, Transform as a, Vec2 as o, Vec3 as s, Window as c, angleToDegree as l, angleToRadian as u, eastNorthUpToFixedFrame as d, encodePosition as f, geodeticSurfaceNormal as p, geodeticToXyz as m, getHeightFromEllipsoid as h, getPickRay as g, getPlaneFromPointNormal as _, getRayPlaneIntersection as v, getWGS84Eccentricity as y, getWGS84EccentricitySquared as b, getWGS84Flattening as x, getWGS84SemiMajorAxis as S, getWGS84SemiMinorAxis as C, northEastDownToFixedFrame as ee, northUpEastToFixedFrame as te, northWestUpToFixedFrame as w, screenToWorld as T, worldToScreen as E, xyzToGeodetic as D } from "@navaramap/engine-api";
+import { Euler as O, MathUtils as k, Matrix4 as A, Plane as j, Ray as M, Vector2 as N, Vector3 as P } from "three";
 //#region src/frames.ts
-function P() {
-	return new k().makeRotationY(Math.PI / 2);
+function F() {
+	return new A().makeRotationY(Math.PI / 2);
 }
-function F(e, t) {
-	let n = new k().multiplyMatrices(e, new k().makeRotationFromEuler(new D(-O.degToRad(t.pitch ?? 0), -O.degToRad(t.heading ?? 0), O.degToRad(t.roll ?? 0), "YXZ")));
+function I(e, t) {
+	let n = new A().multiplyMatrices(e, new A().makeRotationFromEuler(new O(-k.degToRad(t.pitch ?? 0), -k.degToRad(t.heading ?? 0), k.degToRad(t.roll ?? 0), "YXZ")));
 	if (t.scale !== void 0) {
 		let e = t.scale;
-		n.scale(typeof e == "number" ? new N(e, e, e) : new N(e.x, e.y, e.z));
+		n.scale(typeof e == "number" ? new P(e, e, e) : new P(e.x, e.y, e.z));
 	}
 	return n;
 }
 //#endregion
 //#region src/intersection.ts
-function I(e, t) {
-	let n = new s(e.x, e.y, e.z), r = new s(t.x, t.y, t.z), i = _(n, r), a = new N(i.normal.x, i.normal.y, i.normal.z), o = new A(a, -i.distance);
+function L(e, t) {
+	let n = new s(e.x, e.y, e.z), r = new s(t.x, t.y, t.z), i = _(n, r), a = new P(i.normal.x, i.normal.y, i.normal.z), o = new j(a, -i.distance);
 	return i.free(), o;
 }
-function L(e, n, r) {
+function R(e, n, r) {
 	let i = new c(e.width, e.height, e.pixelRatio);
 	i.width *= i.pixelRatio, i.height *= i.pixelRatio;
-	let s = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = g(i, s, l, new o(r.x, r.y)), f = new N(d.origin.x, d.origin.y, d.origin.z), p = new N(d.direction.x, d.direction.y, d.direction.z), m = new j(f, p);
+	let s = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = g(i, s, l, new o(r.x, r.y)), f = new P(d.origin.x, d.origin.y, d.origin.z), p = new P(d.direction.x, d.direction.y, d.direction.z), m = new M(f, p);
 	return d.free(), m;
 }
-function R(e, t) {
+function z(e, t) {
 	let n = new i(new s(e.origin.x, e.origin.y, e.origin.z), new s(e.direction.x, e.direction.y, e.direction.z)), r = _(new s(t.normal.x * -t.constant, t.normal.y * -t.constant, t.normal.z * -t.constant), new s(t.normal.x, t.normal.y, t.normal.z)), a = v(n, r);
 	if (a) {
-		let e = new N(a.x, a.y, a.z);
+		let e = new P(a.x, a.y, a.z);
 		return a.free(), e;
 	}
 }
-function z(e) {
+function B(e) {
 	let t = new s(e.x, e.y, e.z);
 	return h(t);
 }
 //#endregion
 //#region src/rte.ts
-var B = Object.freeze({ value: 1 });
-function V(e, t = new N(), n = new N()) {
+var V = Object.freeze({ value: 1 });
+function H(e, t = new P(), n = new P()) {
 	let r = f(e.x, e.y, e.z);
 	return t.set(r.high.x, r.high.y, r.high.z), n.set(r.low.x, r.low.y, r.low.z), r.free(), {
 		high: t,
 		low: n
 	};
 }
-var re = (e, t, n = new k()) => {
+var ne = (e, t, n = new A()) => {
 	n.multiplyMatrices(t, e);
 	let r = n.elements;
 	return r[12] = 0, r[13] = 0, r[14] = 0, n;
 };
-function H(e, t, n = new N(), r = new k()) {
+function U(e, t, n = new P(), r = new A()) {
 	r.multiplyMatrices(e, t), n.setFromMatrixPosition(r);
 	let i = r.elements;
 	return i[12] = 0, i[13] = 0, i[14] = 0, {
@@ -58,17 +58,17 @@ function H(e, t, n = new N(), r = new k()) {
 		rotationScale: r
 	};
 }
-var U = new k(), W = new N(), G = (e, t) => {
-	U.copy(t).invert(), W.copy(e).applyMatrix4(U);
-	let n = f(W.x, W.y, W.z), r = n.high, i = n.low, a = {
-		high: new N(r.x, r.y, r.z),
-		low: new N(i.x, i.y, i.z)
+var W = new A(), G = new P(), K = (e, t) => {
+	W.copy(t).invert(), G.copy(e).applyMatrix4(W);
+	let n = f(G.x, G.y, G.z), r = n.high, i = n.low, a = {
+		high: new P(r.x, r.y, r.z),
+		low: new P(i.x, i.y, i.z)
 	};
 	return n.free(), a;
-}, K = class {
+}, q = class {
 	_raw;
 	constructor(e, t) {
-		this._raw = new n(new r(e.lat, e.lng, e.height), new r(t.lat, t.lng, t.height));
+		this._raw = new n(new r(u(e.lat), u(e.lng), e.height), new r(u(t.lat), u(t.lng), t.height));
 	}
 	get distance() {
 		return this._raw.distance;
@@ -77,40 +77,40 @@ var U = new k(), W = new N(), G = (e, t) => {
 		return this._raw.converged;
 	}
 	get startHeading() {
-		return this._raw.start_heading;
+		return l(this._raw.start_heading);
 	}
 	get endHeading() {
-		return this._raw.end_heading;
+		return l(this._raw.end_heading);
 	}
 	get start() {
 		let e = this._raw.start;
 		return {
-			lat: e.lat,
-			lng: e.lng,
+			lat: l(e.lat),
+			lng: l(e.lng),
 			height: e.height
 		};
 	}
 	get end() {
 		let e = this._raw.end;
 		return {
-			lat: e.lat,
-			lng: e.lng,
+			lat: l(e.lat),
+			lng: l(e.lng),
 			height: e.height
 		};
 	}
 	interpolatePoints(e) {
 		let t = this._raw.interpolateGeodeticPoints(e ?? null), n = [];
 		for (let e of t) n.push({
-			lat: e.lat,
-			lng: e.lng,
+			lat: l(e.lat),
+			lng: l(e.lng),
 			height: e.height
 		}), e.free();
 		return n;
 	}
 	interpolateDistance(e) {
 		let t = this._raw.interpolateDistance(e), n = {
-			lat: t.lat,
-			lng: t.lng,
+			lat: l(t.lat),
+			lng: l(t.lng),
 			height: t.height
 		};
 		return t.free(), n;
@@ -121,78 +121,78 @@ var U = new k(), W = new N(), G = (e, t) => {
 };
 //#endregion
 //#region src/index.ts
-async function q() {
+async function J() {
 	await e();
 }
-function J(e) {
-	let t = m(new r(e.lat, e.lng, e.height)), n = new N(t.x, t.y, t.z);
+function Y(e) {
+	let t = m(new r(u(e.lat), u(e.lng), e.height)), n = new P(t.x, t.y, t.z);
 	return t.free(), n;
 }
-function Y(e) {
-	let t = new s(e.x, e.y, e.z), n = E(t), r = {
-		lat: n.lat,
-		lng: n.lng,
+function X(e) {
+	let t = new s(e.x, e.y, e.z), n = D(t), r = {
+		lat: l(n.lat),
+		lng: l(n.lng),
 		height: n.height
 	};
 	return n.free(), r;
 }
-function X(e) {
+function Z(e) {
 	return u(e);
 }
-function ie(e) {
+function re(e) {
 	return l(e);
 }
-function ae(e, n, r) {
+function ie(e, n, r) {
 	let i = new c(e.width, e.height, e.pixelRatio);
 	i.width *= i.pixelRatio, i.height *= i.pixelRatio;
-	let s = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = w(i, s, l, new o(r.x, r.y));
+	let s = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = T(i, s, l, new o(r.x, r.y));
 	if (!d) return;
-	let f = new N(d.x, d.y, d.z);
+	let f = new P(d.x, d.y, d.z);
 	return d.free(), f;
 }
-function oe(e) {
-	let t = p(new r(e.lat, e.lng, e.height)), n = new N(t.x, t.y, t.z);
+function ae(e) {
+	let t = p(new r(u(e.lat), u(e.lng), e.height)), n = new P(t.x, t.y, t.z);
 	return t.free(), n;
 }
-function Z(e) {
+function oe(e) {
 	let t = new s(e.x, e.y, e.z), n = d(t);
-	return new k().fromArray(n);
+	return new A().fromArray(n);
 }
 function se(e) {
-	let t = new s(e.x, e.y, e.z), n = ne(t);
-	return new k().fromArray(n);
+	let t = new s(e.x, e.y, e.z), n = ee(t);
+	return new A().fromArray(n);
 }
 function Q(e) {
-	let t = new s(e.x, e.y, e.z), n = S(t);
-	return new k().fromArray(n);
+	let t = new s(e.x, e.y, e.z), n = te(t);
+	return new A().fromArray(n);
 }
 function ce(e) {
-	let t = new s(e.x, e.y, e.z), n = C(t);
-	return new k().fromArray(n);
+	let t = new s(e.x, e.y, e.z), n = w(t);
+	return new A().fromArray(n);
 }
 function $(e) {
-	return Q(e).multiply(P());
+	return Q(e).multiply(F());
 }
 function le(e) {
-	return F($(J({
-		lng: O.degToRad(e.lng),
-		lat: O.degToRad(e.lat),
+	return I($(Y({
+		lng: e.lng,
+		lat: e.lat,
 		height: e.height ?? 0
 	})), e);
 }
 function ue(e, n, r) {
 	let i = new c(e.width, e.height, e.pixelRatio);
 	i.width *= i.pixelRatio, i.height *= i.pixelRatio;
-	let o = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = T(i, o, l, new s(r.x, r.y, r.z));
+	let o = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = E(i, o, l, new s(r.x, r.y, r.z));
 	if (!d) return;
-	let f = new M(d.x, d.y);
+	let f = new N(d.x, d.y);
 	return d.free(), f;
 }
 function de() {
-	return ee();
+	return S();
 }
 function fe() {
-	return te();
+	return C();
 }
 function pe() {
 	return b();
@@ -204,4 +204,4 @@ function he() {
 	return y();
 }
 //#endregion
-export { K as EllipsoidGeodesic, B as RTE_ONE_UNIFORM, G as calcCameraPosition, re as calcModelMatrixRTE, H as composeWorldMatrixForRTE, ae as convertScreenToWorld, ue as convertWorldToScreen, X as degreeToRadian, Z as eastNorthUpToFixedFrame, V as encodePositionRTE, oe as geodeticSurfaceNormal, J as geodeticToVector3, z as getHeightFromEllipsoid, L as getPickRay, I as getPlaneFromPointNormal, R as getRayPlaneIntersection, he as getWGS84Eccentricity, pe as getWGS84EccentricitySquared, me as getWGS84Flattening, de as getWGS84SemiMajorAxis, fe as getWGS84SemiMinorAxis, le as headingPitchRollToFixedFrame, q as initNavaraApi, se as northEastDownToFixedFrame, Q as northUpEastToFixedFrame, ce as northWestUpToFixedFrame, ie as radianToDegree, Y as vector3ToGeodetic, $ as westUpNorthToFixedFrame };
+export { q as EllipsoidGeodesic, V as RTE_ONE_UNIFORM, K as calcCameraPosition, ne as calcModelMatrixRTE, U as composeWorldMatrixForRTE, ie as convertScreenToWorld, ue as convertWorldToScreen, Z as degreeToRadian, oe as eastNorthUpToFixedFrame, H as encodePositionRTE, ae as geodeticSurfaceNormal, Y as geodeticToVector3, B as getHeightFromEllipsoid, R as getPickRay, L as getPlaneFromPointNormal, z as getRayPlaneIntersection, he as getWGS84Eccentricity, pe as getWGS84EccentricitySquared, me as getWGS84Flattening, de as getWGS84SemiMajorAxis, fe as getWGS84SemiMinorAxis, le as headingPitchRollToFixedFrame, J as initNavaraApi, se as northEastDownToFixedFrame, Q as northUpEastToFixedFrame, ce as northWestUpToFixedFrame, re as radianToDegree, X as vector3ToGeodetic, $ as westUpNorthToFixedFrame };

package/dist/index.umd.cjs

@@ -1 +1 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@navaramap/engine-api"),require("three")):typeof define==`function`&&define.amd?define([`exports`,`@navaramap/engine-api`,`three`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.NavaraThreeApi={},e._navaramap_engine_api,e.three))})(this,function(e,t,n){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var r=Object.create,i=Object.defineProperty,a=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,s=Object.getPrototypeOf,c=Object.prototype.hasOwnProperty,l=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var s=o(t),l=0,u=s.length,d;l<u;l++)d=s[l],!c.call(e,d)&&d!==n&&i(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(r=a(t,d))||r.enumerable});return e};t=((e,t,n)=>(n=e==null?{}:r(s(e)),l(t||!e||!e.__esModule||!c.call(e,`default`)?i(n,`default`,{value:e,enumerable:!0}):n,e)))(t,1);function u(){return new n.Matrix4().makeRotationY(Math.PI/2)}function d(e,t){let r=new n.Matrix4().multiplyMatrices(e,new n.Matrix4().makeRotationFromEuler(new n.Euler(-n.MathUtils.degToRad(t.pitch??0),-n.MathUtils.degToRad(t.heading??0),n.MathUtils.degToRad(t.roll??0),`YXZ`)));if(t.scale!==void 0){let e=t.scale;r.scale(typeof e==`number`?new n.Vector3(e,e,e):new n.Vector3(e.x,e.y,e.z))}return r}function f(e,r){let i=new t.Vec3(e.x,e.y,e.z),a=new t.Vec3(r.x,r.y,r.z),o=(0,t.getPlaneFromPointNormal)(i,a),s=new n.Vector3(o.normal.x,o.normal.y,o.normal.z),c=new n.Plane(s,-o.distance);return o.free(),c}function p(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.getPickRay)(a,o,s,new t.Vec2(i.x,i.y)),l=new n.Vector3(c.origin.x,c.origin.y,c.origin.z),u=new n.Vector3(c.direction.x,c.direction.y,c.direction.z),d=new n.Ray(l,u);return c.free(),d}function m(e,r){let i=new t.Ray(new t.Vec3(e.origin.x,e.origin.y,e.origin.z),new t.Vec3(e.direction.x,e.direction.y,e.direction.z)),a=(0,t.getPlaneFromPointNormal)(new t.Vec3(r.normal.x*-r.constant,r.normal.y*-r.constant,r.normal.z*-r.constant),new t.Vec3(r.normal.x,r.normal.y,r.normal.z)),o=(0,t.getRayPlaneIntersection)(i,a);if(o){let e=new n.Vector3(o.x,o.y,o.z);return o.free(),e}}function h(e){let n=new t.Vec3(e.x,e.y,e.z);return(0,t.getHeightFromEllipsoid)(n)}var g=Object.freeze({value:1});function _(e,r=new n.Vector3,i=new n.Vector3){let a=(0,t.encodePosition)(e.x,e.y,e.z);return r.set(a.high.x,a.high.y,a.high.z),i.set(a.low.x,a.low.y,a.low.z),a.free(),{high:r,low:i}}var v=(e,t,r=new n.Matrix4)=>{r.multiplyMatrices(t,e);let i=r.elements;return i[12]=0,i[13]=0,i[14]=0,r};function y(e,t,r=new n.Vector3,i=new n.Matrix4){i.multiplyMatrices(e,t),r.setFromMatrixPosition(i);let a=i.elements;return a[12]=0,a[13]=0,a[14]=0,{position:r,rotationScale:i}}var b=new n.Matrix4,x=new n.Vector3,S=(e,r)=>{b.copy(r).invert(),x.copy(e).applyMatrix4(b);let i=(0,t.encodePosition)(x.x,x.y,x.z),a=i.high,o=i.low,s={high:new n.Vector3(a.x,a.y,a.z),low:new n.Vector3(o.x,o.y,o.z)};return i.free(),s},C=class{_raw;constructor(e,n){this._raw=new t.EllipsoidGeodesic(new t.LLE(e.lat,e.lng,e.height),new t.LLE(n.lat,n.lng,n.height))}get distance(){return this._raw.distance}get converged(){return this._raw.converged}get startHeading(){return this._raw.start_heading}get endHeading(){return this._raw.end_heading}get start(){let e=this._raw.start;return{lat:e.lat,lng:e.lng,height:e.height}}get end(){let e=this._raw.end;return{lat:e.lat,lng:e.lng,height:e.height}}interpolatePoints(e){let t=this._raw.interpolateGeodeticPoints(e??null),n=[];for(let e of t)n.push({lat:e.lat,lng:e.lng,height:e.height}),e.free();return n}interpolateDistance(e){let t=this._raw.interpolateDistance(e),n={lat:t.lat,lng:t.lng,height:t.height};return t.free(),n}dispose(){this._raw.free()}};async function w(){await(0,t.default)()}function T(e){let r=(0,t.geodeticToXyz)(new t.LLE(e.lat,e.lng,e.height)),i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function E(e){let n=new t.Vec3(e.x,e.y,e.z),r=(0,t.xyzToGeodetic)(n),i={lat:r.lat,lng:r.lng,height:r.height};return r.free(),i}function D(e){return(0,t.angleToRadian)(e)}function O(e){return(0,t.angleToDegree)(e)}function k(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.screenToWorld)(a,o,s,new t.Vec2(i.x,i.y));if(!c)return;let l=new n.Vector3(c.x,c.y,c.z);return c.free(),l}function A(e){let r=(0,t.geodeticSurfaceNormal)(new t.LLE(e.lat,e.lng,e.height)),i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function j(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.eastNorthUpToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function M(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northEastDownToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function N(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northUpEastToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function P(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northWestUpToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function F(e){return N(e).multiply(u())}function I(e){return d(F(T({lng:n.MathUtils.degToRad(e.lng),lat:n.MathUtils.degToRad(e.lat),height:e.height??0})),e)}function L(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.worldToScreen)(a,o,s,new t.Vec3(i.x,i.y,i.z));if(!c)return;let l=new n.Vector2(c.x,c.y);return c.free(),l}function R(){return(0,t.getWGS84SemiMajorAxis)()}function z(){return(0,t.getWGS84SemiMinorAxis)()}function B(){return(0,t.getWGS84EccentricitySquared)()}function V(){return(0,t.getWGS84Flattening)()}function H(){return(0,t.getWGS84Eccentricity)()}e.EllipsoidGeodesic=C,e.RTE_ONE_UNIFORM=g,e.calcCameraPosition=S,e.calcModelMatrixRTE=v,e.composeWorldMatrixForRTE=y,e.convertScreenToWorld=k,e.convertWorldToScreen=L,e.degreeToRadian=D,e.eastNorthUpToFixedFrame=j,e.encodePositionRTE=_,e.geodeticSurfaceNormal=A,e.geodeticToVector3=T,e.getHeightFromEllipsoid=h,e.getPickRay=p,e.getPlaneFromPointNormal=f,e.getRayPlaneIntersection=m,e.getWGS84Eccentricity=H,e.getWGS84EccentricitySquared=B,e.getWGS84Flattening=V,e.getWGS84SemiMajorAxis=R,e.getWGS84SemiMinorAxis=z,e.headingPitchRollToFixedFrame=I,e.initNavaraApi=w,e.northEastDownToFixedFrame=M,e.northUpEastToFixedFrame=N,e.northWestUpToFixedFrame=P,e.radianToDegree=O,e.vector3ToGeodetic=E,e.westUpNorthToFixedFrame=F});
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@navaramap/engine-api"),require("three")):typeof define==`function`&&define.amd?define([`exports`,`@navaramap/engine-api`,`three`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.NavaraThreeApi={},e._navaramap_engine_api,e.three))})(this,function(e,t,n){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var r=Object.create,i=Object.defineProperty,a=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,s=Object.getPrototypeOf,c=Object.prototype.hasOwnProperty,l=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var s=o(t),l=0,u=s.length,d;l<u;l++)d=s[l],!c.call(e,d)&&d!==n&&i(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(r=a(t,d))||r.enumerable});return e};t=((e,t,n)=>(n=e==null?{}:r(s(e)),l(t||!e||!e.__esModule||!c.call(e,`default`)?i(n,`default`,{value:e,enumerable:!0}):n,e)))(t,1);function u(){return new n.Matrix4().makeRotationY(Math.PI/2)}function d(e,t){let r=new n.Matrix4().multiplyMatrices(e,new n.Matrix4().makeRotationFromEuler(new n.Euler(-n.MathUtils.degToRad(t.pitch??0),-n.MathUtils.degToRad(t.heading??0),n.MathUtils.degToRad(t.roll??0),`YXZ`)));if(t.scale!==void 0){let e=t.scale;r.scale(typeof e==`number`?new n.Vector3(e,e,e):new n.Vector3(e.x,e.y,e.z))}return r}function f(e,r){let i=new t.Vec3(e.x,e.y,e.z),a=new t.Vec3(r.x,r.y,r.z),o=(0,t.getPlaneFromPointNormal)(i,a),s=new n.Vector3(o.normal.x,o.normal.y,o.normal.z),c=new n.Plane(s,-o.distance);return o.free(),c}function p(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.getPickRay)(a,o,s,new t.Vec2(i.x,i.y)),l=new n.Vector3(c.origin.x,c.origin.y,c.origin.z),u=new n.Vector3(c.direction.x,c.direction.y,c.direction.z),d=new n.Ray(l,u);return c.free(),d}function m(e,r){let i=new t.Ray(new t.Vec3(e.origin.x,e.origin.y,e.origin.z),new t.Vec3(e.direction.x,e.direction.y,e.direction.z)),a=(0,t.getPlaneFromPointNormal)(new t.Vec3(r.normal.x*-r.constant,r.normal.y*-r.constant,r.normal.z*-r.constant),new t.Vec3(r.normal.x,r.normal.y,r.normal.z)),o=(0,t.getRayPlaneIntersection)(i,a);if(o){let e=new n.Vector3(o.x,o.y,o.z);return o.free(),e}}function h(e){let n=new t.Vec3(e.x,e.y,e.z);return(0,t.getHeightFromEllipsoid)(n)}var g=Object.freeze({value:1});function _(e,r=new n.Vector3,i=new n.Vector3){let a=(0,t.encodePosition)(e.x,e.y,e.z);return r.set(a.high.x,a.high.y,a.high.z),i.set(a.low.x,a.low.y,a.low.z),a.free(),{high:r,low:i}}var v=(e,t,r=new n.Matrix4)=>{r.multiplyMatrices(t,e);let i=r.elements;return i[12]=0,i[13]=0,i[14]=0,r};function y(e,t,r=new n.Vector3,i=new n.Matrix4){i.multiplyMatrices(e,t),r.setFromMatrixPosition(i);let a=i.elements;return a[12]=0,a[13]=0,a[14]=0,{position:r,rotationScale:i}}var b=new n.Matrix4,x=new n.Vector3,S=(e,r)=>{b.copy(r).invert(),x.copy(e).applyMatrix4(b);let i=(0,t.encodePosition)(x.x,x.y,x.z),a=i.high,o=i.low,s={high:new n.Vector3(a.x,a.y,a.z),low:new n.Vector3(o.x,o.y,o.z)};return i.free(),s},C=class{_raw;constructor(e,n){this._raw=new t.EllipsoidGeodesic(new t.LLE((0,t.angleToRadian)(e.lat),(0,t.angleToRadian)(e.lng),e.height),new t.LLE((0,t.angleToRadian)(n.lat),(0,t.angleToRadian)(n.lng),n.height))}get distance(){return this._raw.distance}get converged(){return this._raw.converged}get startHeading(){return(0,t.angleToDegree)(this._raw.start_heading)}get endHeading(){return(0,t.angleToDegree)(this._raw.end_heading)}get start(){let e=this._raw.start;return{lat:(0,t.angleToDegree)(e.lat),lng:(0,t.angleToDegree)(e.lng),height:e.height}}get end(){let e=this._raw.end;return{lat:(0,t.angleToDegree)(e.lat),lng:(0,t.angleToDegree)(e.lng),height:e.height}}interpolatePoints(e){let n=this._raw.interpolateGeodeticPoints(e??null),r=[];for(let e of n)r.push({lat:(0,t.angleToDegree)(e.lat),lng:(0,t.angleToDegree)(e.lng),height:e.height}),e.free();return r}interpolateDistance(e){let n=this._raw.interpolateDistance(e),r={lat:(0,t.angleToDegree)(n.lat),lng:(0,t.angleToDegree)(n.lng),height:n.height};return n.free(),r}dispose(){this._raw.free()}};async function w(){await(0,t.default)()}function T(e){let r=(0,t.geodeticToXyz)(new t.LLE((0,t.angleToRadian)(e.lat),(0,t.angleToRadian)(e.lng),e.height)),i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function E(e){let n=new t.Vec3(e.x,e.y,e.z),r=(0,t.xyzToGeodetic)(n),i={lat:(0,t.angleToDegree)(r.lat),lng:(0,t.angleToDegree)(r.lng),height:r.height};return r.free(),i}function D(e){return(0,t.angleToRadian)(e)}function O(e){return(0,t.angleToDegree)(e)}function k(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.screenToWorld)(a,o,s,new t.Vec2(i.x,i.y));if(!c)return;let l=new n.Vector3(c.x,c.y,c.z);return c.free(),l}function A(e){let r=(0,t.geodeticSurfaceNormal)(new t.LLE((0,t.angleToRadian)(e.lat),(0,t.angleToRadian)(e.lng),e.height)),i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function j(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.eastNorthUpToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function M(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northEastDownToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function N(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northUpEastToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function P(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northWestUpToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function F(e){return N(e).multiply(u())}function I(e){return d(F(T({lng:e.lng,lat:e.lat,height:e.height??0})),e)}function L(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.worldToScreen)(a,o,s,new t.Vec3(i.x,i.y,i.z));if(!c)return;let l=new n.Vector2(c.x,c.y);return c.free(),l}function R(){return(0,t.getWGS84SemiMajorAxis)()}function z(){return(0,t.getWGS84SemiMinorAxis)()}function B(){return(0,t.getWGS84EccentricitySquared)()}function V(){return(0,t.getWGS84Flattening)()}function H(){return(0,t.getWGS84Eccentricity)()}e.EllipsoidGeodesic=C,e.RTE_ONE_UNIFORM=g,e.calcCameraPosition=S,e.calcModelMatrixRTE=v,e.composeWorldMatrixForRTE=y,e.convertScreenToWorld=k,e.convertWorldToScreen=L,e.degreeToRadian=D,e.eastNorthUpToFixedFrame=j,e.encodePositionRTE=_,e.geodeticSurfaceNormal=A,e.geodeticToVector3=T,e.getHeightFromEllipsoid=h,e.getPickRay=p,e.getPlaneFromPointNormal=f,e.getRayPlaneIntersection=m,e.getWGS84Eccentricity=H,e.getWGS84EccentricitySquared=B,e.getWGS84Flattening=V,e.getWGS84SemiMajorAxis=R,e.getWGS84SemiMinorAxis=z,e.headingPitchRollToFixedFrame=I,e.initNavaraApi=w,e.northEastDownToFixedFrame=M,e.northUpEastToFixedFrame=N,e.northWestUpToFixedFrame=P,e.radianToDegree=O,e.vector3ToGeodetic=E,e.westUpNorthToFixedFrame=F});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@navaramap/three-api",
   "type": "module",
-  "version": "0.0.8",
+  "version": "0.1.0",
   "main": "dist/index.umd.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,8 +22,8 @@
     "three": ">=0.183.0"
   },
   "dependencies": {
-    "@navaramap/core": "0.0.8",
-    "@navaramap/engine-api": "0.0.8"
+    "@navaramap/core": "0.1.0",
+    "@navaramap/engine-api": "0.1.0"
   },
   "devDependencies": {
     "@types/three": "0.185.1",

package/src/ellipsoidGeodesic.ts

@@ -2,17 +2,21 @@ import type { LatLngHeight } from "@navaramap/core";
 import {
   EllipsoidGeodesic as EllipsoidGeodesicImpl,
   LLE,
+  angleToRadian,
+  angleToDegree,
 } from "@navaramap/engine-api";
 
 /**
  * Wrapper class for geodesic calculations on an ellipsoid surface.
  * Precomputes common variables for optimization when instantiated.
  *
+ * All latitudes/longitudes and headings are in **degrees**.
+ *
  * @example
  * ```typescript
  * const geodesic = new EllipsoidGeodesic(
- *   { lat: 0.5, lng: 2.0, height: 0 },
- *   { lat: 0.6, lng: 2.1, height: 0 }
+ *   { lat: 35.6812, lng: 139.7671, height: 0 },
+ *   { lat: 34.7025, lng: 135.4959, height: 0 }
  * );
  *
  * console.log(geodesic.distance);
@@ -27,13 +31,13 @@ export class EllipsoidGeodesic {
 
   /**
    * Create a new geodesic between two points on the ellipsoid.
-   * @param start - Start point in geodetic coordinates (lat/lng in radians)
-   * @param end - End point in geodetic coordinates (lat/lng in radians)
+   * @param start - Start point in geodetic coordinates (lat/lng in degrees)
+   * @param end - End point in geodetic coordinates (lat/lng in degrees)
    */
   constructor(start: LatLngHeight, end: LatLngHeight) {
     this._raw = new EllipsoidGeodesicImpl(
-      new LLE(start.lat, start.lng, start.height),
-      new LLE(end.lat, end.lng, end.height),
+      new LLE(angleToRadian(start.lat), angleToRadian(start.lng), start.height),
+      new LLE(angleToRadian(end.lat), angleToRadian(end.lng), end.height),
     );
   }
 
@@ -52,32 +56,40 @@ export class EllipsoidGeodesic {
     return this._raw.converged;
   }
 
-  /** Heading at the start point in radians */
+  /** Heading at the start point in degrees */
   get startHeading(): number {
-    return this._raw.start_heading;
+    return angleToDegree(this._raw.start_heading);
   }
 
-  /** Heading at the end point in radians */
+  /** Heading at the end point in degrees */
   get endHeading(): number {
-    return this._raw.end_heading;
+    return angleToDegree(this._raw.end_heading);
   }
 
-  /** Start point in geodetic coordinates */
+  /** Start point in geodetic coordinates (lat/lng in degrees) */
   get start(): LatLngHeight {
     const lle = this._raw.start;
-    return { lat: lle.lat, lng: lle.lng, height: lle.height };
+    return {
+      lat: angleToDegree(lle.lat),
+      lng: angleToDegree(lle.lng),
+      height: lle.height,
+    };
   }
 
-  /** End point in geodetic coordinates */
+  /** End point in geodetic coordinates (lat/lng in degrees) */
   get end(): LatLngHeight {
     const lle = this._raw.end;
-    return { lat: lle.lat, lng: lle.lng, height: lle.height };
+    return {
+      lat: angleToDegree(lle.lat),
+      lng: angleToDegree(lle.lng),
+      height: lle.height,
+    };
   }
 
   /**
    * Interpolate points along the geodesic path.
    * @param granularity - Distance between interpolated points in meters (optional)
-   * @returns Array of interpolated points in geodetic coordinates
+   * @returns Array of interpolated points in geodetic coordinates (lat/lng in degrees)
    */
   interpolatePoints(granularity?: number): LatLngHeight[] {
     const wasmPoints = this._raw.interpolateGeodeticPoints(granularity ?? null);
@@ -85,8 +97,8 @@ export class EllipsoidGeodesic {
     const results: LatLngHeight[] = [];
     for (const point of wasmPoints) {
       results.push({
-        lat: point.lat,
-        lng: point.lng,
+        lat: angleToDegree(point.lat),
+        lng: angleToDegree(point.lng),
         height: point.height,
       });
       point.free();
@@ -98,14 +110,14 @@ export class EllipsoidGeodesic {
   /**
    * Interpolate a point at a specific distance along the geodesic path.
    * @param distance - Distance from start point in meters
-   * @returns Interpolated point in geodetic coordinates
+   * @returns Interpolated point in geodetic coordinates (lat/lng in degrees)
    */
   interpolateDistance(distance: number): LatLngHeight {
     const wasmPoint = this._raw.interpolateDistance(distance);
 
     const result: LatLngHeight = {
-      lat: wasmPoint.lat,
-      lng: wasmPoint.lng,
+      lat: angleToDegree(wasmPoint.lat),
+      lng: angleToDegree(wasmPoint.lng),
       height: wasmPoint.height,
     };
 

package/src/index.test.ts

@@ -28,6 +28,8 @@ vi.mock("@navaramap/engine-api", () => {
     default: vi.fn(),
     LLE,
     Vec3,
+    angleToRadian: (deg: number) => (deg * Math.PI) / 180,
+    angleToDegree: (rad: number) => (rad * 180) / Math.PI,
     // Transparent model: the rotation is pinned to the NUE basis at
     // lng 0 / lat 0 (column-major: x = north (0,0,1), y = up (1,0,0),
     // z = east (0,1,0)), but the ORIGIN is threaded through from the

package/src/index.ts

@@ -23,7 +23,7 @@ import initApi, {
   getWGS84Flattening as nvGetWGS84Flattening,
   getWGS84Eccentricity as nvGetWGS84Eccentricity,
 } from "@navaramap/engine-api";
-import { Vector3, Vector2, Matrix4, MathUtils, PerspectiveCamera } from "three";
+import { Vector3, Vector2, Matrix4, PerspectiveCamera } from "three";
 
 import {
   composeHeadingPitchRoll,
@@ -56,11 +56,13 @@ export async function initNavaraApi() {
 
 /**
  * Converts geodetic coordinates (longitude, latitude, height) to a Cartesian Vector3 in ECEF coordinates.
- * @param lle - Geodetic coordinates (lng in radians, lat in radians, height in meters)
+ * @param lle - Geodetic coordinates (lng in degrees, lat in degrees, height in meters)
  * @returns Cartesian Vector3 in Earth-Centered Earth-Fixed (ECEF) coordinates
  */
 export function geodeticToVector3(lle: LatLngHeight): Vector3 {
-  const pos = geodeticToXyz(new LLE(lle.lat, lle.lng, lle.height));
+  const pos = geodeticToXyz(
+    new LLE(angleToRadian(lle.lat), angleToRadian(lle.lng), lle.height),
+  );
   const result = new Vector3(pos.x, pos.y, pos.z);
   pos.free();
   return result;
@@ -69,12 +71,16 @@ export function geodeticToVector3(lle: LatLngHeight): Vector3 {
 /**
  * Converts a Cartesian Vector3 in ECEF coordinates to geodetic coordinates.
  * @param xyz - Cartesian Vector3 in Earth-Centered Earth-Fixed (ECEF) coordinates
- * @returns Geodetic coordinates (lng in radians, lat in radians, height in meters)
+ * @returns Geodetic coordinates (lng in degrees, lat in degrees, height in meters)
  */
 export function vector3ToGeodetic(xyz: Vector3): LatLngHeight {
   const vec3 = new Vec3(xyz.x, xyz.y, xyz.z);
   const lle = xyzToGeodetic(vec3);
-  const result = { lat: lle.lat, lng: lle.lng, height: lle.height };
+  const result = {
+    lat: angleToDegree(lle.lat),
+    lng: angleToDegree(lle.lng),
+    height: lle.height,
+  };
   lle.free();
   return result;
 }
@@ -155,11 +161,13 @@ export function convertScreenToWorld(
 
 /**
  * Computes the surface normal vector at a geodetic position on the WGS84 ellipsoid.
- * @param lle - Geodetic coordinates (lng in radians, lat in radians, height in meters)
+ * @param lle - Geodetic coordinates (lng in degrees, lat in degrees, height in meters)
  * @returns Unit normal vector pointing outward from the ellipsoid surface
  */
 export function geodeticSurfaceNormal(lle: LatLngHeight): Vector3 {
-  const pos = nvGeodeticSurfaceNormal(new LLE(lle.lat, lle.lng, lle.height));
+  const pos = nvGeodeticSurfaceNormal(
+    new LLE(angleToRadian(lle.lat), angleToRadian(lle.lng), lle.height),
+  );
   const result = new Vector3(pos.x, pos.y, pos.z);
   pos.free();
   return result;
@@ -240,7 +248,6 @@ export function westUpNorthToFixedFrame(origin: Vector3): Matrix4 {
  * engines differ in which axis they treat as an asset's front, so a model
  * ported from one may need a multiple of 90° added to its heading.
  *
- * NOTE: unlike {@link geodeticToVector3} and the other helpers in this module,
  * `lng`/`lat` and all angles here are in **degrees**, matching
  * `setCamera` and the `geodetic` mesh Descriptor field.
  *
@@ -254,8 +261,8 @@ export function headingPitchRollToFixedFrame(
   placement: Omit<GeodeticPlacement, "heightReference">,
 ): Matrix4 {
   const origin = geodeticToVector3({
-    lng: MathUtils.degToRad(placement.lng),
-    lat: MathUtils.degToRad(placement.lat),
+    lng: placement.lng,
+    lat: placement.lat,
     height: placement.height ?? 0,
   });
   return composeHeadingPitchRoll(westUpNorthToFixedFrame(origin), placement);