ECEFPosition

Part of Locations in the Python API reference.

Related guidance: concepts/locations, how-to/observe-location, how-to/pli-entities.

Runnable examples: publish_location.py, get_ecn_location.py.

from picogrid_ecn_client import ECEFPosition

An EPSG:4978 Cartesian position in metres.

ECEFPosition(*, x: float, y: float, z: float)

Source · models/location.py

Fields

Name	Type	Required	Default	Constraints	Description
x	float	yes	—	finite	Finite EPSG:4978 X coordinate in metres, towards the intersection of the equator and the prime meridian.
y	float	yes	—	finite	Finite EPSG:4978 Y coordinate in metres, completing the right-handed set.
z	float	yes	—	finite	Finite EPSG:4978 Z coordinate in metres, towards the north pole.

to_geodetic

Convert to latitude, longitude, and height above the WGS-84 ellipsoid.

def to_geodetic() -> GeodeticPosition

Returns

Type	Description
GeodeticPosition	The equivalent WGS-84 coordinate triple.

Raises

Exception	Description
ValidationError	If the position is near the center of the ellipsoid, where geodetic coordinates are not defined, with code degenerate_ecef.

Source · models/location.py