BlueSphere
Package: com.eegeo.mapapi.bluesphere
A BlueSphere is a model that can be used for GPS and indoor positioning systems to show the users positon and oritentation.
BlueSphere has the following properties:
Position
The LatLng location of the blue sphere on the map. The position can be changed at any point if you want to move the blue sphere.
Bearing
The bearing the blue sphere is facing in degrees from north.
Elevation
For outdoor maps, the height above ground of the sphere model’s center, in meters. For indoor maps, the height above the floor of the base of the leader-line, in meters.
IndoorMapId
Blue spheres can be displayed on indoor maps. This property stores the string identifier of the indoor map on which the blue sphere is to be displayed. For outdoor blue spheres, this property is empty. When setting an IndoorMapId the IndoorFloorId must also be specified.
IndoorFloorId
For a blue sphere displayed on an indoor map, the identifier of the floor on which the blue sphere is to be displayed.
Enabled
The blue sphere is disabled by default and can be set to enabled via this method.
ShowOrientation
Enables or disables the orientation arrow on the blue sphere. Enabled by default
Public methods in this class must be called on the Android UI thread.
Methods
LatLng getPosition()
Returns the position of the blue sphere.
Returns: A LatLng object representing the location of the blue sphere on the map’s surface.
void setPosition(LatLng position)
Sets the location of this blue sphere.
| Type | argument | Description |
|---|---|---|
| LatLng | position | A LatLng coordinate. |
double getBearing()
Returns the bearing of the blue sphere.
Returns: A double representing the bearing of the blue sphere.
void setBearing(double bearing)
Sets the bearing of this blue sphere.
| Type | argument | Description |
|---|---|---|
| double | bearing | A double bearing in degrees. |
double getElevation()
For outdoor maps, the height above ground of the sphere model’s center, in meters. For indoor maps, the height above the floor of the base of the leader-line, in meters.
Returns: A height, in meters.
void setElevation(double elevation)
Sets the elevation of this blue sphere.
| Type | argument | Description |
|---|---|---|
| double | elevation | For outdoor maps, the height above ground of the sphere model’s center, in meters. For indoor maps, the height above the floor of the base of the leader-line, in meters. |
String getIndoorMapId()
Gets the identifier of an indoor map on which this blue sphere should be displayed, if any.
Returns: For a blue sphere on an indoor map, the string identifier of the indoor map; otherwise an empty string.
void setIndoorMap(String indoorMapId, int floorId)
Sets the indoor map and floor id of this blue sphere.
| Type | argument | Description |
|---|---|---|
| String | indoorMapId | For a blue sphere on an indoor map, the string identifier of the indoor map; otherwise an empty string. |
| int | floorId | For a blue sphere on an indoor map, the identifier of the floor; otherwise 0. |
int getIndoorFloorId()
Gets the identifier of an indoor map floor on which this blue sphere should be displayed, if any.
Returns: For a blue sphere on an indoor map, the identifier of the floor; otherwise 0.
void setIndoorFloorId(int floorId)
Sets the identifier of an indoor map floor on which this blue sphere should be displayed, if any.
| Type | argument | Description |
|---|---|---|
| int | floorId | For a blue sphere on an indoor map, the identifier of the floor; otherwise 0. |
boolean getEnabled()
Gets the boolean which indicates if the blue sphere is enabled.
Returns: A boolean that enables the blue sphere.
void setEnabled(boolean enabled)
Sets the boolean which enables the blue sphere to display.
| Type | argument | Description |
|---|---|---|
| boolean | enabled | A boolean that enables the blue sphere. |
boolean getAccuracyRingEnabled()
Gets the boolean which indicates if the accuracy ring is enabled.
Returns: A boolean that enables the accuracy ring.
void setAccuracyRingEnabled(boolean accuracyRingEnabled)
Sets the boolean which enables the accuracy ring to display.
| Type | argument | Description |
|---|---|---|
| boolean | accuracyRingEnabled | A boolean that enables the accuracy ring. |
float getCurrentLocationAccuracy()
Gets the float which indicates current location accuracy in meters.
Returns: A float representing the current location accuracy in meters.
void setCurrentLocationAccuracy(float accuracyInMeters)
Sets the current location accuracy of blue sphere.
| Type | argument | Description |
|---|---|---|
| float | accuracyInMeters | A float representing current location accuracy in meters. |
void showOrientation(boolean orientationVisible)
Sets the boolean that indicates whether the blue sphere displays orientation information.
| Type | argument | Description |
|---|---|---|
| boolean | orientationVisible | A boolean setting the visibility of the blue sphere orientation arrow. |