Class GeoPosition

java.lang.Object
com.azure.core.models.GeoPosition
All Implemented Interfaces:
com.azure.json.JsonSerializable<GeoPosition>

public final class GeoPosition extends Object implements com.azure.json.JsonSerializable<GeoPosition>

Represents a geographic position in GeoJSON format.

This class encapsulates a geographic position defined by longitude, latitude, and optionally altitude. It provides methods to access these properties.

This class also provides a toJson(JsonWriter) method to serialize the geographic position to JSON, and a fromJson(JsonReader) method to deserialize a geographic position from JSON.

This class is useful when you want to work with a geographic position in a geographic context. For example, you can use it to represent a location on a map or a point in a geographic dataset.

See Also:
  • JsonSerializable
  • Constructor Details

    • GeoPosition

      public GeoPosition(double longitude, double latitude)
      Constructs a geo position.
      Parameters:
      longitude - Longitudinal position.
      latitude - Latitudinal position.
    • GeoPosition

      public GeoPosition(double longitude, double latitude, Double altitude)
      Constructs a geo position.
      Parameters:
      longitude - Longitudinal position.
      latitude - Latitudinal position.
      altitude - Altitude position.
  • Method Details

    • getLongitude

      public double getLongitude()
      The longitudinal position of the geometric position.
      Returns:
      The longitudinal position.
    • getLatitude

      public double getLatitude()
      The latitudinal position of the geometric position.
      Returns:
      The latitudinal position.
    • getAltitude

      public Double getAltitude()
      The altitude of the geometric position.
      Returns:
      The altitude.
    • count

      public int count()
      Gets the number of coordinates used to compose the position.

      This will return either 2 or 3 depending on whether altitude is set.

      Returns:
      The number of coordinates used to compose the position.
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
    • equals

      public boolean equals(Object obj)
      Overrides:
      equals in class Object
    • toString

      public String toString()
      Overrides:
      toString in class Object
    • toJson

      public com.azure.json.JsonWriter toJson(com.azure.json.JsonWriter jsonWriter) throws IOException
      Specified by:
      toJson in interface com.azure.json.JsonSerializable<GeoPosition>
      Throws:
      IOException
    • fromJson

      public static GeoPosition fromJson(com.azure.json.JsonReader jsonReader) throws IOException
      Reads a JSON stream into a GeoPosition.
      Parameters:
      jsonReader - The JsonReader being read.
      Returns:
      The GeoPosition that the JSON stream represented, or null if it pointed to JSON null.
      Throws:
      IllegalStateException - If the GeoPosition has less than two or more than three positions in the array.
      IOException - If a GeoPosition fails to be read from the jsonReader.