GeoPosition

GeoPosition[{lat,lon}]

represents a geodetic position with latitude lat and longitude lon.

GeoPosition[{lat,lon,h}]

represents a geodetic position with height h relative to the reference ellipsoid.

GeoPosition[{lat,lon,h},datum]

represents a geodetic position referring to the specified datum.

GeoPosition[{{lat1,lon1},{lat2,lon2},},datum]

represents an array of geodetic positions.

GeoPosition[entity]

returns the geodetic position of the specified geographical entity.

Details

  • Latitude and longitude values in GeoPosition[{lat,lon}] can be given as decimal degrees, DMS strings, or Quantity angles.
  • Height h in GeoPosition[{lat,lon,h}] can be given as a numeric object in meters or as a Quantity length.
  • Height h in GeoPosition[{lat,lon,h}] is geodetic height, measured with respect to the reference ellipsoid.
  • GeoPosition[{lat,lon,h,t}] includes a time t that can be given as a numeric object or as a DateObject specification. A numeric t represents GMT time measured in seconds since the beginning of January 1, 1900.
  • Valid latitude angles range from to 90 degrees. Longitude angles, traditionally between and 180 degrees, are unrestricted and interpreted modulo 360 degrees.
  • A GeoPosition object with no explicit height assumes height zero with respect to the reference ellipsoid. A GeoPosition object with no explicit time assumes the current date.
  • GeoPosition[{lat,lon}] assumes the default datum "ITRF00".
  • Standard datums can be specified by name. Typical named datums include:
  • "ITRF00"International Terrestrial Reference Frame 2000
    "NAD27"North American Datum of 1927
    "NAD83CORS96"North American Datum of 1983 (CORS96)
  • The complete list of named datums and reference ellipsoids is given by GeodesyData[].
  • GeoPosition[GeoPosition[{lat,lon},datum1],datum2] converts between datums.
  • GeoPosition[pos,datum] converts from any type of geographic position. The following coordinate types can be given: GeoPosition, GeoPositionXYZ, GeoPositionENU, GeoGridPosition.
  • GeoPosition[pos] converts from any type of geographic position, keeping the same datum of pos.
  • GeoPosition can represent a geodetic position on a body other than Earth using GeoPosition[coords,body], where body is an Entity object of domains "Planet", "MinorPlanet", or "PlanetaryMoon".
  • For an image with Exif location information, GeoPosition[image] returns that information as a GeoPosition object.
  • For extended entities, GeoPosition[entity] uses when possible the position of the geographic center of the entity.
  • GeoPosition[][prop] gives the specified property of a geo position.
  • Possible properties include:
  • "AbsoluteTime"date as number of seconds since Jan 1, 1900, 00:00 GMT
    "Count"number of positions in the GeoPosition object
    "Data"first argument of the GeoPosition object
    "DateList"date list {y,m,d,h,m,s} in GMT time
    "DateObject"full date object
    "Datum"datum of the GeoPosition object
    "Depth"point depth: 0 for a single position, 1 for a list of them,
    "Dimension"number of coordinates for each position
    "Elevation"numeric elevation in meters, with respect to the ellipsoid
    "Latitude"numeric latitude in degrees
    "LatitudeLongitude"numeric {lat,lon} pair in degrees
    "Longitude"numeric longitude in degrees
    "LongitudeLatitude"numeric {lon,lat} pair in degrees
    "PackingType"Integer or Real if data is packed; None otherwise

Examples

open all close all

Basic Examples  (4)

A geodetic position in the default reference frame:

In[1]:=
Click for copyable input
Out[1]=

The geo location of a city:

In[1]:=
Click for copyable input
Out[1]=

The current position of the International Space Station, including height and time information:

In[1]:=
Click for copyable input
Out[1]=

A position that explicitly refers to the ITRF00 reference frame:

In[1]:=
Click for copyable input
Out[1]=

Convert this position to NAD 83 (CORS96) coordinates:

In[2]:=
Click for copyable input
Out[2]=

Convert to Cartesian geocentric coordinates:

In[3]:=
Click for copyable input
Out[3]=

Convert back to geodetic coordinates:

In[4]:=
Click for copyable input
Out[4]=

Convert back to ITRF00:

In[5]:=
Click for copyable input
Out[5]=

Scope  (17)

Generalizations & Extensions  (3)

Applications  (3)

Properties & Relations  (7)

Possible Issues  (2)

Neat Examples  (1)

Introduced in 2008
(7.0)
|
Updated in 2019
(12.0)