GeoPath (Lucene 10.5.0 spatial3d API)
Description: declaration: package: org.apache.lucene.spatial3d.geom, interface: GeoPath

Package org.apache.lucene.spatial3d.geom

# Interface GeoPath

All Superinterfaces:
  `Bounded`, `GeoArea`, `GeoAreaShape`, `GeoBounds`, `GeoDistance`, `GeoDistanceShape`, `GeoMembershipShape`, `GeoOutsideDistance`, `GeoShape`, `Membership`, `PlanetObject`, `SerializableObject`

public interface GeoPath extends GeoDistanceShape
Interface describing a path.

WARNING: This API is experimental and might change in incompatible ways in the next release.

- ## Field Summary

  ### Fields inherited from interface org.apache.lucene.spatial3d.geom.GeoArea

  `CONTAINS, DISJOINT, OVERLAPS, WITHIN`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `double`
  `computeNearestDistance(DistanceStyle distanceStyle, double x, double y, double z)`
  Compute the nearest path distance to the GeoPoint.
  `default double`
  `computeNearestDistance(DistanceStyle distanceStyle, GeoPoint point)`
  Compute the nearest path distance to the GeoPoint.
  `double`
  `computePathCenterDistance(DistanceStyle distanceStyle, double x, double y, double z)`
  Compute the shortest distance from the path center to the GeoPoint.
  `default double`
  `computePathCenterDistance(DistanceStyle distanceStyle, GeoPoint point)`
  Compute the shortest distance from the path center to the GeoPoint.

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.Bounded

  `getBounds`

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.GeoArea

  `getRelationship`

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.GeoAreaShape

  `intersects`

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.GeoDistance

  `computeDeltaDistance, computeDeltaDistance, computeDistance, computeDistance`

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.GeoDistanceShape

  `getDistanceBounds`

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.GeoOutsideDistance

  `computeOutsideDistance, computeOutsideDistance`

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.GeoShape

  `getEdgePoints, intersects`

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.Membership

  `isWithin, isWithin`

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.PlanetObject

  `getPlanetModel`

  ### Methods inherited from interface org.apache.lucene.spatial3d.geom.SerializableObject

  `write`

- ## Method Details

  - ### computeNearestDistance

    default double computeNearestDistance(DistanceStyle distanceStyle, GeoPoint point)
    Compute the nearest path distance to the GeoPoint. The path distance will not include the distance from the path itself to the point, but just the distance along the path to the nearest point on the path.
    Parameters:
      `distanceStyle` - is the distance style.
      `point` - is the point to compute the distance to.
    Returns:
      the distance to the nearest path point.

  - ### computeNearestDistance

    double computeNearestDistance(DistanceStyle distanceStyle, double x, double y, double z)
    Compute the nearest path distance to the GeoPoint. The path distance will not include the distance from the path itself to the point, but just the distance along the path to the nearest point on the path.
    Parameters:
      `x` - is the point's unit x coordinate (using U.S. convention).
      `y` - is the point's unit y coordinate (using U.S. convention).
      `z` - is the point's unit z coordinate (using U.S. convention).
    Returns:
      the distance to the nearest path point.

  - ### computePathCenterDistance

    default double computePathCenterDistance(DistanceStyle distanceStyle, GeoPoint point)
    Compute the shortest distance from the path center to the GeoPoint. The distance is meant to allow comparisons between different paths to find the one that goes closest to a point.
    Parameters:
      `distanceStyle` - is the distance style.
      `point` - is the point to compute the distance to.
    Returns:
      the shortest distance from the path center to the point.

  - ### computePathCenterDistance

    double computePathCenterDistance(DistanceStyle distanceStyle, double x, double y, double z)
    Compute the shortest distance from the path center to the GeoPoint. The distance is meant to allow comparisons between different paths to find the one that goes closest to a point.
    Parameters:
      `distanceStyle` - is the distance style.
      `x` - is the point's unit x coordinate (using U.S. convention).
      `y` - is the point's unit y coordinate (using U.S. convention).
      `z` - is the point's unit z coordinate (using U.S. convention).
    Returns:
      the shortest distance from the path center to the point.