This component displays and dynamically updates geographical map, road map, terrain map, or satellite image. It uses Google Maps as data source. |
|
The map may show markers indicating current location of devices providing GPS data, along with their track paths.
This is what a map component looks like:
Zooming and Panning
The map can me panned by clicking a certain point and dropping it over another map location. This will move map center accordingly.
Zooming into/from current mouse location is enabled by using mouse wheel.
Datum
This map component uses WGS84 datum. Any device that provides location data for AggreGate must be set up to use WGS84 datum in order to be properly displayed on the map.
Common Properties
Width, Height, Bindings, Visible, Border, Tooltip
Custom Properties
Instructs map renderer to set zoom level automatically so that map center, all markers and paths will be visible without additional panning.
Property name: detectZoom
Property type: Boolean
Zoom Level
Zoom Level defines the resolution of the current view. Zoom levels between 0 (the lowest zoom level, in which the entire world can be seen on one map) to 21+ (down to individual buildings) are possible.
Each succeeding zoom level doubles the precision in both horizontal and vertical dimensions.
|
Not all zoom levels appear at all locations on the earth. Zoom levels vary depending on location, as data in some parts of the globe is more granular than in other locations. |
If no data is available for the current location and selected zoom level, the map will display blank image instead.
Property name: zoom
Property type: Integer
Map Type
Four map types are supported:
| • | Roadmap (default) specifies a standard road map image. |
| • | Satellite specifies a satellite image. |
| • | Terrain specifies a physical relief map image, showing terrain and vegetation. |
| • | Hybrid specifies a hybrid of the satellite and roadmap image, showing a transparent layer of major streets and place names on the satellite image. |
Property name: mapType
Property type: String
Tracked Devices
This setting is a context mask. All Devices providing their location data those context paths match this mask will be shown on the map as markers.
The mask may resolve to:
| • | An individual Device |
| • | All Devices in the system |
| • | All Devices of a certain user |
| • | Device group |
Property name: deviceMask
Property type: String
Displayable Track Length
A number of Device track waypoints to show on the map.
|
An attempt to show too many waypoints may cause Google Maps API usage rules violation. In this case, an empty map will be displayed. Decrease this settings to avoid the problem. |
|
Device setting history storage must be enabled for Location (location) setting of a Device in order to keep historical track information and display it on the map. |
Property name: trackLength
Property type: Integer
Location Properties
This setting allows to specify how the map is centered:
| • | Automatic. The map is centered to fit all devices and track waypoints. This option may be combined with Auto-detect Zoom Level to ensure that map displays all available data. |
| • | Geolocation. Allows to center map using a geocode, i.e. city name, street address, or zip code. |
| • | Latitute/Longitude. Manual specification of map center coordinates (latitude and longitude). |
Property name: locationType
Property type: Integer
Geolocation
This option is enabled if Location Type is Geolocation. It specifies map center's geocode, e.g. Berkeley,CA.
Property name: geoLocation
Property type: String
Latitude
This option is enabled if Location Type is Latitude/Longitude. It specifies latitude of the fixed map center.
Property name: latitude
Property type: Float
Longitude
This option is enabled if Location Type is Latitude/Longitude. It specifies longitude of the fixed map center.
Property name: longitude
Property type: Float
Common Events
Hidden, Shown, Moved, Resized, Mouse Clicked, Mouse Pressed, Mouse Released, Mouse Entered, Mouse Exited, Mouse Moved, Mouse Wheel Moved, Key Typed, Key Pressed, Key Released, Focus Gained, Focus Lost