HERE Android SDK Developer's Guide

PlatformDataItem

The class PlatformDataItem is a member of com.here.android.mpa.pde .

Class Summary

public class PlatformDataItem

   implements java.util.Map

extends java.lang.Object

Single record from the Platform Data Extension request for a given layer.

[For complete information, see the section Class Details]

Nested Class Summary

Table 1. Nested Classes in PlatformDataItem
Nested Classes

public static final enumeration PlatformDataItem.ConditionType

Type of the condition entity as described by the CONDITION_TYPE field.

public static final enumeration PlatformDataItem.VehicleType

The possible vehicle types that are allowed on a link as described by the VEHICLE_TYPES field.

Method Summary

Table 2. Methods in PlatformDataItem
Methods

public void clear ()

Since this class is immutable, this method only throws UnsupportedOperationException and does not do anything else.

public boolean containsKey (Object key)

Returns whether this PlatformDataItem contains the specified key.

public boolean containsValue (Object value)

Returns whether this PlatformDataItem contains the specified value.

public Set entrySet ()

Returns a Set containing all of the mappings in this PlatformDataItem .

public boolean equals (Object o)

Compares the argument to the receiver, and returns true if the specified object is a PlatformDataItem and both PlatformDataItem s contain the same mappings.

public Map extract ()

Extracts the underlying raw data to a regular Map object.

public String get (Object key)

Returns the value of the mapping with the specified key.

public int getAverageHeight ()

DTM_AVG_HEIGHT data.

public ConditionType getConditionType ()

CONDITION_TYPE data.

public java.util.List <GeoCoordinate> getCoordinates ()

LAT and LON data.

public String getLinkId ()

LINK_ID data.

public String[] getLinkIds ()

LINK_IDS data.

public float getLinkLength ()

LINK_LENGTH data.

public java.util.EnumSet <VehicleType> getVehicleTypes ()

VEHICLE_TYPES data.

public int hashCode ()

Returns an integer hash code for the receiver.

public boolean isEmpty ()

Returns whether this item is empty.

public Set keySet ()

Returns a set of the keys contained in this PlatformDataItem .

public String put (String key, String value)

Since this class is immutable, this method only throws UnsupportedOperationException and does not do anything else.

public void putAll (Map map)

Since this class is immutable, this method only throws UnsupportedOperationException and does not do anything else.

public String remove (Object key)

Since this class is immutable, this method only throws UnsupportedOperationException and does not do anything else.

public int size ()

Returns the number of mappings in this PlatformDataItem .

public Collection values ()

Returns a Collection of the values contained in this PlatformDataItem .

Class Details

Single record from the Platform Data Extension request for a given layer. Implements Map interface, where the key is the attribute name and the value is the value of that attribute. This class is immutable.

To avoid overhead when dealing with large data sets, all the items returned by this class are dynamically created on demand. Due to that fact this object keeps reference to its parent object. If you require normal Java behavior, you can obtain regular Java collection of underlying data with extract() method.

Method Details

public void clear ()

Since this class is immutable, this method only throws UnsupportedOperationException and does not do anything else.

public boolean containsKey (Object key)

Returns whether this PlatformDataItem contains the specified key.

Parameters:

  • key

    the key to search for.

Returns:

true if this item contains the specified key, false otherwise.

public boolean containsValue (Object value)

Returns whether this PlatformDataItem contains the specified value.

Parameters:

  • value

    the value to search for.

Returns:

true if this item contains the specified value, false otherwise.

public Set entrySet ()

Returns a Set containing all of the mappings in this PlatformDataItem . Each mapping is an instance of Map.Entry.

Returns:

a set of the mappings

public boolean equals (Object o)

Compares the argument to the receiver, and returns true if the specified object is a PlatformDataItem and both PlatformDataItem s contain the same mappings.

Parameters:

  • o

Returns:

boolean true if the Object is the same as this Object false if it is different from this Object.

See also:

hashCode()

entrySet()

public Map extract ()

Extracts the underlying raw data to a regular Map object.

All the items returned by this class are dynamically created on demand. Due to that fact this object keeps reference to its parent object. If you require normal Java behavior, you can convert this class to regular Java collection with this method.

Returns:

Content of the PlatformDataItem converted to regular Java collection.

public String get (Object key)

Returns the value of the mapping with the specified key.

Parameters:

  • key

    the key.

Returns:

the value of the mapping with the specified key, or null if no mapping for the specified key is found.

public int getAverageHeight ()

DTM_AVG_HEIGHT data.

The average height [centimeters above WGS84 ellipsoid] along the link.

Returns:

Average height in centimeters. Integer.MIN_VALUE if not available.

public ConditionType getConditionType ()

CONDITION_TYPE data.

Returns traffic sign condition type. Valid only for TRAFFIC_SIGN_FCx layer data.

Returns:

ConditionType instance.

public java.util.List <GeoCoordinate> getCoordinates ()

LAT and LON data.

Latitude and longitude coordinates [10^-5 degree WGS84] along the polyline or of the reference node and the non reference node. Comma separated. Each value is relative to the previous.

Returns:

List containing parsed coordinates.

public String getLinkId ()

LINK_ID data.

Positive 64 bit Integer that globally identifies the road link, also across map releases. Link IDs are never reused.

Returns:

String value of the link ID.

public String[] getLinkIds ()

LINK_IDS data.

Comma separated list of Permanent link IDs that describe a route path. A negative sign means that this link was driven towards reference node. If the list contains only one link, then a 'B' prefix tells that it applies for both driving directions. Each link ID is a positive 64 bit Integer that globally identifies the road link, also across map releases. Link IDs are never reused.

Returns:

Array of link IDS or null if not available.

public float getLinkLength ()

LINK_LENGTH data.

The link length in meters. This method returns the whole link length, no matter whether the link spans across several tiles. The link length is computed by straight lines between subsequent shape points, no splines or other smoothing functions or geodesic computations are used.

Returns:

Link length in meters. Float.MIN_VALUE if not available.

public java.util.EnumSet <VehicleType> getVehicleTypes ()

VEHICLE_TYPES data.

Access Characteristics that identify the vehicle types that are allowed on a link, allowed on a lane or to which condition applies.

Returns:

Set of allowed vehicle types, null if not available.

public int hashCode ()

Returns an integer hash code for the receiver. Object s which are equal return the same value for this method.

Returns:

the receiver's hash.

See also:

equals(Object)

public boolean isEmpty ()

Returns whether this item is empty.

Returns:

true if this item has no elements, false otherwise.

See also:

size()

public Set keySet ()

Returns a set of the keys contained in this PlatformDataItem .

Returns:

a set of the keys.

public String put (String key, String value)

Since this class is immutable, this method only throws UnsupportedOperationException and does not do anything else.

Parameters:

  • key

    ignored

  • value

    ignored

public void putAll (Map map)

Since this class is immutable, this method only throws UnsupportedOperationException and does not do anything else.

Parameters:

  • map

    ignored

public String remove (Object key)

Since this class is immutable, this method only throws UnsupportedOperationException and does not do anything else.

Parameters:

  • key

    ignored

public int size ()

Returns the number of mappings in this PlatformDataItem .

Returns:

the number of mappings in this PlatformDataItem.

public Collection values ()

Returns a Collection of the values contained in this PlatformDataItem .

Returns:

a collection of the values contained in this item.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.