Package globus.glmap

Class GLMapVectorObject

  • @ParametersAreNonnullByDefault
public class GLMapVectorObject
extends GLNativeObject
    GLMapVectorObject is a bridge class, to work with GLMap internal representation of vector object.

    • Method Detail

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object

      • equals

        public boolean equals​(java.lang.Object other)
        Overrides:
        equals in class java.lang.Object

      • createFromGeoJSON

        @Nullable
public static GLMapVectorObjectList createFromGeoJSON​(java.lang.String geoJSON)
        Creates an array of GLMapVectorObject from string
        Parameters:
        geoJSON - source string with geo JSON data
        Returns:
        objects constructed from geo JSON data

      • createFromGeoJSONStream

        @Nullable
public static GLMapVectorObjectList createFromGeoJSONStream​(java.io.InputStream geoJSON)
        Creates an array of GLMapVectorObject from stream
        Parameters:
        geoJSON - stream with geo JSON data
        Returns:
        objects constructed from geo JSON data

      • createMultiline

        @NonNull
public static GLMapVectorObject createMultiline​(MapPoint[][] multilinePoints)
        Loads multiline geometry to vector object 
        
         MapPoint[] line1 = new MapPoint[5];
         line1[0] = new MapPoint(27.7151, 53.8869); // Minsk
         line1[1] = new MapPoint(30.5186, 50.4339); // Kiev
         line1[2] = new MapPoint(21.0103, 52.2251); // Warsaw
         line1[3] = new MapPoint(13.4102, 52.5037); // Berlin
         line1[4] = new MapPoint(2.3343, 48.8505); // Paris
         MapPoint[] line2 = new MapPoint[3];
         line2[0] = new MapPoint(4.9021, 52.3690); // Amsterdam
         line2[1] = new MapPoint(4.3458, 50.8263); // Brussel
         line2[2] = new MapPoint(6.1296, 49.6072); // Luxembourg
         MapPoint[][] multiline = {line1, line2};
         obj.loadMultiline(multiline);
        Parameters:
        multilinePoints - Data to load to vector object
        Returns:
        Created vector object with multiline

      • createPoint

        @NonNull
public static GLMapVectorObject createPoint​(MapPoint point)
        Loads point to vector object
        Parameters:
        point - Data to load to vector object
        Returns:
        Created vector object with multiline

      • createPolygon

        @NonNull
public static GLMapVectorObject createPolygon​(MapPoint[][] outerRings,
                                              @Nullable
                                              MapPoint[][] innerRings)
        Loads polygon geometry to vector object. 
        
         MapPoint[][] outerRings = {outerRing1, outerRing2};
         MapPoint[][] innerRings = {innerRing}, innerRing2};
         obj.loadPolygon(outerRings, innerRings);
        Parameters:
        outerRings - outer rings of polygon.
        innerRings - inner rings of polygons (holes).
        Returns:
        Created vector object with polygon.

      • createGeoLine

        @NonNull
public static GLMapVectorObject createGeoLine​(MapPoint start,
                                              MapPoint end,
                                              double quality)
        Adds big circle line from `start` to `end`. Useful to display plane routes. Should be used only on empty `GLMapVectorObject`
        Parameters:
        start - Start point
        end - End point
        quality - Maximum distance from point to line, used for simplification in Douglas Peucker algorithm. Units is map internal coordinates.
        Returns:
        Created vector object with geo-line.

      • getType

        public int getType()
        Returns type of object
        Returns:
        type of object

      • point

        @NonNull
public MapPoint point()
        Returns:
        some point that belongs to vector object.

      • getBBox

        @NonNull
public GLMapBBox getBBox()
        Returns bbox of object
        Returns:
        bbox of object

      • getMultilinePoints

        @Nullable
public MapPoint[][] getMultilinePoints()
        Returns points of multiline for object with type of TYPE_LINE
        Returns:
        points of multiline

      • getMultilineGeoPoints

        @Nullable
public MapGeoPoint[][] getMultilineGeoPoints()

      • asGeoJSON

        @Nullable
public java.lang.String asGeoJSON()
        Serialize object as GeoJSON
        Returns:
        GeoJSON string

      • findNearestPoint

        @Nullable
public MapPoint findNearestPoint​(GLMapView mapView,
                                 MapPoint point,
                                 double distanceInPoints)
        Calculates nearest point of vector object from given point
        Parameters:
        mapView - MapView where track is displayed
        point - Point from where calculate nearest point
        distanceInPoints - maximum distance from track in points
        Returns:
        nearest point on track from given point or null if track is too far from given point

      • valueForKey

        @Nullable
public java.lang.String valueForKey​(java.lang.String key)
        Returns value for the key
        Parameters:
        key - Key of requested value
        Returns:
        value associated with given key. (if loaded from geo JSON get values from "properties" section)

      • valuesForKey

        @Nullable
public java.lang.String[] valuesForKey​(java.lang.String key)
        Returns values for the key
        Parameters:
        key - Key of requested values
        Returns:
        array of values associated with given key

      • setValueForKey

        public void setValueForKey​(java.lang.String key,
                           @Nullable
                           java.lang.String value)
        Sets value for key
        Parameters:
        key - Key of value
        value - value to set

      • spannedName

        @Nullable
public android.text.SpannableString spannedName​(java.lang.Object normal,
                                                java.lang.Object highlighted,
                                                int flags,
                                                GLMapLocaleSettings localeSettings)
        Returns spanned name where parts that matched search are highlighted.
        Parameters:
        normal - normal span (must support clone method)
        highlighted - highlighted span (must support clone method)
        flags - flag that is passed to setSpan
        localeSettings - locale settings to use
        Returns:
        spanned name of object

      • localizedName

        @Nullable
public java.lang.String localizedName​(GLMapLocaleSettings localeSettings)
        Returns localized name.
        Parameters:
        localeSettings - locale settings to use
        Returns:
        spanned name of object