Stay organized with collections Save and categorize content based on your preferences.
Describes a specific location, elevation, and orientation relative to Earth. It is comprised of:
An
GeospatialPose
can be retrieved from
Earth.getCameraGeospatialPose()
and by converting a
Pose
using
Earth.getGeospatialPose(Pose)
.
Public Methods Inherited Methods Fromclass java.lang.Object
Object
clone()
boolean
void
finalize()
final Class<?>
getClass()
int
hashCode()
final void
notify()
final void
notifyAll()
String
toString()
final void
wait(long arg0, int arg1)
final void
wait(long arg0)
final void
wait()
public double getAltitude()
Returns the GeospatialPose
's altitude in meters as elevation above the WGS84 ellipsoid.
public float[] getEastUpSouthQuaternion()
Extracts the orientation from a Geospatial pose. The output quaternion represents the rotation matrix transforming a vector from the target to the east-up-south (EUS) coordinate system (i.e. X+ points east, Y+ points up, and Z+ points south). Values are written in the order {x, y, z, w}.
public double getHeading () getHeadingpublic double getHeading()
This method was deprecated.
This function has been deprecated in favor of getEastUpSouthQuaternion()
which provides orientation values in 3D space. To determine a value analogous to the heading value, calculate the yaw, pitch, and roll values from getEastUpSouthQuaternion()
. When the device is pointing downwards, i.e. perpendicular to the ground, heading is analoguous to roll, and when the device is upright in the device's default orientation mode, heading is analogous to yaw.
Returns the GeospatialPose
's heading. Heading is specified in degrees clockwise from true north and approximates the direction the device is facing. The value returned when facing north is 0°, when facing east is 90°, when facing south is +/-180°, and when facing west is -90°.
This function will return heading values for GeospatialPose
from Earth.getCameraGeospatialPose()
and returns 0 for all other GeospatialPose
objects. You may use getEastUpSouthQuaternion()
instead, which provides a more detailed orientation in 3D space.
The heading approximation is based on the rotation of the device in its current orientation mode (i.e. portrait or landscape) and pitch. For example, when the device is held vertically or upright, the heading is based on the camera optical axis. If the device is held horizontally, looking downwards, the heading is based on the top of the device, with respect to the orientation mode.
Note: Heading is currently only supported in the device's default orientation mode, which is portrait mode for most supported devices.
Details Returns the heading component of this pose's orientation in [-180.0, 180.0] degree range. public double getHeadingAccuracy () getHeadingAccuracypublic double getHeadingAccuracy()
This method was deprecated.
This function has deprecated in favor of getOrientationYawAccuracy()
, which provides the accuracy analogous to the heading accuracy when the device is held upright in the default orientation mode.
Returns the GeospatialPose
's estimated heading accuracy.
This function will return values for GeospatialPose
from Earth.getCameraGeospatialPose()
and returns 0 for all other GeospatialPose
objects.
We define heading accuracy as the radius of the 68th percentile confidence level around getHeading()
. In other words, there is a 68% probability that the true heading is within getHeadingAccuracy()
of this GeospatialPose
's heading. Larger values indicate lower accuracy.
For example, if the estimated heading is 60°, and the heading accuracy is 10°, then there is an estimated 68% probability of the true heading being between 50° and 70°.
Details Returns the accuracy of the heading confidence in degrees. public double getHorizontalAccuracy () getHorizontalAccuracypublic double getHorizontalAccuracy()
Returns the GeospatialPose
's estimated horizontal accuracy in meters with respect to latitude and longitude.
We define horizontal accuracy as the radius of the 68th percentile confidence level around the estimated horizontal location. In other words, if you draw a circle centered at this GeospatialPose
's latitude and longitude, and with a radius equal to the horizontal accuracy, then there is a 68% probability that the true location is inside the circle. Larger numbers indicate lower accuracy.
For example, if the latitude is 10°, longitude is 10°, and the returned value is 15, then there is a 68% probability that the true location is within 15 meters of the (10°, 10°) latitude/longitude coordinate.
Details Returns the estimated horizontal accuracy with respect to latitude and longitude, radial, in meters. public double getLatitude () getLatitudepublic double getLatitude()
Returns the GeospatialPose
's latitude in degrees. Positive values are north of the equator as defined by the WGS84 specification.
public double getLongitude()
Returns the GeospatialPose
's longitude in degrees. Positive values are east of the prime meridian as defined by the WGS84 specification.
public double getOrientationYawAccuracy()
Returns the GeospatialPose
's estimated orientation yaw angle accuracy. Yaw rotation is the angle between the pose's compass direction and north, and can be determined from getEastUpSouthQuaternion()
.
We define yaw accuracy as the estimated radius of the 68th percentile confidence level around yaw angles from getEastUpSouthQuaternion()
. In other words, there is a 68% probability that the true yaw angle is within getOrientationYawAccuracy()
of this GeospatialPose
's orientation. Larger values indicate lower accuracy.
For example, if the estimated yaw angle is 60°, and the orientation yaw accuracy is 10°, then there is an estimated 68% probability of the true yaw angle being between 50° and 70°.
Details Returns the accuracy of the orientation yaw confidence in degrees. public double getVerticalAccuracy () getVerticalAccuracypublic double getVerticalAccuracy()
Returns the GeospatialPose
's estimated altitude accuracy in meters.
We define vertical accuracy as the radius of the 68th percentile confidence level around the estimated altitude. In other words, there is a 68% probability that the true altitude is within the output value (in meters) of this GeospatialPose
's altitude (above or below). Larger numbers indicate lower accuracy.
For example, if this GeospatialPose
's altitude is 100 meters, and the output value is 20 meters, there is a 68% chance that the true altitude is within 20 meters of 100 meters.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-31 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-31 UTC."],[[["`GeospatialPose` describes a location and orientation on Earth using latitude, longitude, altitude, and orientation relative to the WGS84 specification."],["Orientation is represented by a quaternion in the East-Up-South (EUS) coordinate system, where X+ points east, Y+ points up, and Z+ points south."],["Accuracy estimates for latitude, longitude, altitude, and orientation are provided as numeric confidence intervals."],["`GeospatialPose` can be obtained from the `Earth` object using methods like `getCameraGeospatialPose()` and `getGeospatialPose(Pose)`."]]],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4