Package com.cercalia.sdk.model.poi

Class Poi

java.lang.Object
com.cercalia.sdk.model.poi.Poi
public final class Poi extends Object
Represents a Point of Interest (POI) result from the Cercalia API.

A POI contains information about a specific location, including its name, category, coordinates, and optionally administrative data or route-related metrics if requested in the search.

Example usage:


 Poi poi = result.getPois().get(0);
 System.out.println("POI: " + poi.getName() + " (" + poi.getCategoryCode() + ")");
 if (poi.getDistance() != null) {
     System.out.println("Distance: " + poi.getDistance() + " meters");
 }

  • Method Details

    • getId

      @NotNull public @NotNull String getId()
      Returns:
      Unique identifier for the POI.

    • getName

      @NotNull public @NotNull String getName()
      Returns:
      Name of the POI.

    • getInfo

      @Nullable public @Nullable String getInfo()
      Returns:
      Additional information or description of the POI.

    • getCategoryCode

      @NotNull public @NotNull String getCategoryCode()
      Returns:
      Primary category code for the POI.

    • getSubcategoryCode

      @Nullable public @Nullable String getSubcategoryCode()
      Returns:
      Subcategory code for the POI.

    • getGeometry

      @Nullable public @Nullable String getGeometry()
      Returns:
      Geometry associated with the POI in WKT format.

    • getDistance

      @Nullable public @Nullable Integer getDistance()
      Returns:
      Euclidean distance from the search center in meters.

    • getPosition

      @Nullable public @Nullable Integer getPosition()
      Returns:
      Position of the POI in the list of results.

    • getRouteDistance

      @Nullable public @Nullable Integer getRouteDistance()
      Returns:
      Distance along the route in meters.

    • getRouteTime

      @Nullable public @Nullable Integer getRouteTime()
      Returns:
      Travel time along the route in seconds.

    • getRouteRealtime

      @Nullable public @Nullable Integer getRouteRealtime()
      Returns:
      Real-time travel time along the route in seconds.

    • getRouteWeight

      @Nullable public @Nullable Integer getRouteWeight()
      Returns:
      Weight value for the route calculation.

    • getCoord

      @NotNull public @NotNull Coordinate getCoord()
      Returns:
      Geographic coordinates of the POI.

    • getGe

      @Nullable public @Nullable PoiGeographicElement getGe()
      Returns:
      Geographic/administrative details for the POI.

    • getPixels

      @Nullable public @Nullable PixelCoordinate getPixels()
      Returns:
      Pixel coordinates for the POI in a static map context.

    • builder

      @NotNull public static @NotNull Poi.Builder builder()
      Returns:
      A new builder instance.

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object