Oracle Maps HTML5 Javascript API Reference

Class: MapMarker

OM. MapMarker

This class represents a map marker which is a point feature. Map markers can have sequential labels
which make them easy to link to entries in a detail view. For example, the map markers can indicate
POIs, such as hotels, on the map while the corresponding details are shown in a separate view on the page.

new MapMarker(mObj)

Parameters:
Name Type Description
mObj Object

An object that specifies the attributes of a marker. It may contain the following attributes.


  • id {String}: The unique id for the map marker.

  • label {String}: Optional. The marker's label text.

  • labelStyle {OM.style.Text}: Optional. The label style of the marker.

  • markerText {String}: Optional. The text on the marker.

  • markerTextStyle {OM.style.Text}: Optional. The text style on the marker.

  • draggable {Boolean}: Optional. If set to true, the marker is draggable.

  • renderingStyle {OM.style.Marker}: Optional. The rendering style for the marker.
    A default marker style will be used if the rendering style is not specified.

  • position {Object}: An object specifying the marker's point location. It may contain the following attributes.


    • x {Number}: The marker's x coordinate

    • y {Number}: The marker's y coordinate

    • srid {Integer}: Optional. The coordinate system for the above x,y values. Default is 8307


  • dragStart {Function}: Optional. The drag start event listener function.

  • dragging {Function}: Optional. The dragging event listener function.

  • dragEnd {Function}: Optional. The drag end event listener function.
Returns:

An instance of OM.MapMarker.

Type
OM.MapMarker

Extends

Members

clipMap

A map of rectangle geometries in data coordinates to be used in clipping feature geometry elements.
Clip area is defined by tile (zoom, x index, and y index)

Inherited From:

tiledFeature

Ideintifies if feature geometries are part of a vector tile layer.

Inherited From:

tileGeometries

For vector tile layers: the feature geometry is defined by tile (zoom, x index, and y index)
Each tile stores the feature geometry elements.

Inherited From:

tooltipCache

Cached tooltip definition

Inherited From:

zoomLevelsGeomClipArea

The clip area for each element of vector tile layer feature by zoom level.
A feature geometry in vector tile is build as a geometry collection, with each element
being part of a different tile.
This is used when rendering the full feature geometry which can have pieces in different tiles.

Inherited From:

zoomLevelsGeometries

Store the feature geometry for a scpecifi level.
For tiled features, a geometry collection can have parts from different tiles.

Inherited From:

Methods

animateToNewLocation(newLocation, options)

Move the FOI to a new location using an animation

Parameters:
Name Type Description
newLocation OM.geometry.Geometry

a point or polyline geometry that specifies
the path along which the FOI moves. If it is a point geometry, the FOI will
move along the straight line from its current location to the new location.
If it is a polyline geometry, the FOI will move along the path defined by the polyline.
options Object

This can have the following attributes:


  • time {int} I milliseconds. It affects the feature moving speed. The default value is 300. A larger
    value results in a slower movement.

  • loop {Boolean} If true, restart the animation from the origin after it is completed

  • bounce {Boolean} If true, the feature will bounce back to the origin after the initial animated motion.
Inherited From:

bringForward()

Brings the feature to the front by one z-index level
( i.e. closer to the top of the displayed feature layers).

Inherited From:
Returns:
Type
void

bringToTop()

Brings the feature all the way to the top of the displayed features or layers.
(i.e. this becomes the topmost feature

Inherited From:
Returns:
Type
void

enableMarkerDraggable(b)

set draggable status (for map markers)

Parameters:
Name Type Description
b boolean

true for draggable, false otherwise
Inherited From:
Returns:
Type
void

getAliasColumnName(column)

Gets the attribute map name for the specified data column in this feature.

Parameters:
Name Type Description
column String

the name of the data column to find a map.
Inherited From:
Returns:

the mapped attribute name, or null if no
map for the input column is found.

Type
String

getAttributes()

Returns all the attributes for this feature. You can look
up each attribute's value based on its name. Note that all
attribute names are stored in uppercase internally.

Inherited From:
Returns:

the attributes object e.g. {"NAME":"Super Store", "SALES":5000}

Type
Object

getAttributeValue(name)

Gets the current value for the specified attribute in this feature.

Parameters:
Name Type Description
name String

the name of the attribute to be returned.
Inherited From:
Returns:

the value for the given attribute, or null if no
attribute with the given name was found.

Type
Object

getClusteredFeatures()

Returns the clustered features that are in this clustered feature, null if this feature is not a cluster feature

Inherited From:
Returns:

a arrays of features. .

Type
Array

getClusterFeature()

Returns the cluster feature where this primitive feature is grouped in.

Inherited From:
Returns:

a cluster feature where the current feature is included;
null if this primitive feature is not in a cluster.

Type
OM.Feature

getClusterId()

Returns its cluster ID, if in a cluster; null otherwise

Inherited From:
Returns:

a cluster ID.

Type
String

getFeaturesInCluster()

For a clustered feature, all features in it will be returned.
For a normal (single) feature, null will be returned.

Inherited From:
Returns:

[Array] feature array or null.

getGeometry()

Return the feature's geometry

Inherited From:
Returns:

the current feature geometry

Type
OM.geometry.Geometry

getID()

Gets the marker id

Returns:

the marker id

Type
String

getLabel()

Gets the marker label value

Returns:

the marker label value

Type
String

getLabelingStyle()

Gets the current labeling style.

Inherited From:
Returns:

The label style

Type
OM.style.Style

getMarkerSRID()

Gets the marker's spatial reference (coordinate system) id.

Returns:

the srid

Type
Number

getMarkerText()

Gets text on a Marker feature.

Inherited From:
Returns:
Type
String

getMarkerX()

Gets the marker's x coordinate

Returns:

the x coordinate

Type
Number

getMarkerY()

Gets the marker's y coordinate

Returns:

the y coordinate

Type
Number

getParentLayer()

Gets this feature's parent layer. The parent layer has a feature array that stores all features.
This feature is an element in that feature array.

Inherited From:
Returns:

the parent layer instance of this feature.

Type
Layer

getPosition()

Gets the marker's position.

Returns:

an Object containing x, y, and srid

Type
Object

getRealColumnName(attr)

Gets the real, original column name for the specified attribute in this feature.

Parameters:
Name Type Description
attr String

the attribute name
Inherited From:
Returns:

the real, original column name, or null if the input attribute name
is not mapped to one.

Type
String

getRenderingStyle()

Get the rendering style

Inherited From:
Returns:

the current rendering style for the feature

Type
OM.style.Style

getStyle()

Gets the map marker's rendering style

Returns:

the map marker's rendering style

Type
OM.style.Marker

hasAttributes()

Check if the feature has the optional attributes object

Inherited From:
Returns:

true if it does, false otherwise.

Type
Boolean

isCluster()

This method checks whether this is a clustered feature.

Inherited From:
Returns:

true if feature is clustered and false if not.

Type
Boolean

isDraggable()

Checks if the map marker is draggable.

Returns:

true if the marker is draggable, false otherwise.

Type
Boolean

isEditable()

This method checks whether the feature is editable or not.

Inherited From:
Returns:

true if feature is editable and false if not.

Type
Boolean

isInCluster()

Returns a Boolean value to indicate if the current feature is in a cluster.

Inherited From:
Returns:

true if this feature in in a cluster; false otherwise.

Type
Boolean

isVisible()

Checks whether the feature is currently visible.

Inherited From:
Returns:

true it is visible, false if not.

Type
Boolean

on()

A shorthand name for the member function addListener.

Inherited From:
Mixes In:

sendBackward()

Sends the feature to the back by one z-index level
(i.e. closer to the bottom of the displayed feature layers).

Inherited From:
Returns:
Type
void

sendToBottom()

Sends the feature all the way to the bottom of the displayed features or layers

Inherited From:
Returns:
Type
void

setDragEndListener(endListener)

Sets the end-drag event listener

Parameters:
Name Type Description
endListener function

the drag-end listener
Returns:
Type
void

setDraggable(draggable)

Sets the map marker's draggable status: true for draggable, flase otherwise.

Parameters:
Name Type Description
draggable Boolean

Set to true to make the marker draggable.
Returns:
Type
void

setDraggingListener(draggingListener)

Sets the dragging event listener

Parameters:
Name Type Description
draggingListener function

the dragStart listener
Returns:
Type
void

setDragStartListener(dragStart)

Sets the start-drag event listener

Parameters:
Name Type Description
dragStart function

the drag-start listener
Returns:
Type
void

setGeometry(geom)

Sets a geometry for the feature. The new geometry should be of the same type
as the existing one, otherwise this call does nothing and returns false.

Parameters:
Name Type Description
geom OM.geometry.Geometry

the new geometry to be set
Inherited From:
Returns:

returns true if geometry is set; false otherwise

Type
Boolean

setID(id)

Sets the id

Parameters:
Name Type Description
id String

the marker id
Returns:
Type
void

setInfoWindowContent(html)

Sets the info window (html) content

Parameters:
Name Type Description
html String

the info window content.
Inherited From:
Returns:
Type
void

setLabel(label)

Sets the label text on the feature.

Parameters:
Name Type Description
label String

The label text to be set.
Inherited From:
Returns:
Type
void

setLabelingStyle(style)

Sets the labeling style to be used when rendering label text.

Parameters:
Name Type Description
style OM.style.Style

The style used for label text
Inherited From:
Returns:
Type
void

setMarkerText(text)

Sets text on Marker feature.

Parameters:
Name Type Description
text String

the text string to add on a marker.
Inherited From:
Returns:
Type
void

setMarkerTextStyle(style)

Sets the map marker's text style

Parameters:
Name Type Description
style OM.style.Text

A OM.style.Text style object
Returns:
Type
void

setPosition(x, y, srid)

Sets the marker's position.

Parameters:
Name Type Description
x Number

the x value to set
y Number

the y value to set
srid Number

the srid value to set, default is 8307
Returns:
Type
void

setRenderingStyle(style)

Set a style

Parameters:
Name Type Description
style OM.style.Style

The rendering style to use for the feature
Inherited From:

setStyle(sty)

Sets a map marker's rendering style

Parameters:
Name Type Description
sty OM.style.Marker

The map marker rendering style.
Returns:
Type
void

setVisible(visible)

Sets the visibility of the feature.

Parameters:
Name Type Description
visible Boolean
Inherited From:
Returns:
Type
void

upperKeys(obj)

Parameters:
Name Type Description
obj Object

a JSON object containing key value pairs. It is one a one level, no nested objects
Inherited From:
Returns:

the same object, but the keys are in upper case.

Type
Object