Last updated

API / geotoolkit / map / layers / Bing / Bing

Class: Bing

layers.Bing.Bing

This shape connects to a Bing Maps server to display a map.

Hierarchy

Table of contents

Constructors
Methods
Css Properties
Name Type Description
alphanumberThe alpha of the layer
cssclassstringThe css class name of this node
idstring | numberId of the node, its a unique identifier
imagepoolnumberThe amount of cache for the tile images
limitsRectLimits of this layer
limits-heightnumberHeight
limits-readonlybooleanReadonly
limits-widthnumberWidth
limits-xnumberLeft
limits-ynumberTop
maxlodnumberThe maximum level of details for the tiles
minlodnumberThe minimum level of details for the tiles
namestringName of the node. It is often used for debugging purposes or to simplify queries
selectablebooleanSelectable node, a boolean to determine if selection should consider this node
sourceAbstractSourceThe layer data source
source-systemstringInitial data coordinate system
source-urlstringData server url
sourceTileTile source
source-imagepoolnumberThe amount of cache for the tile images
source-maxlodnumberThe maximum level of details for the tiles
source-minlodnumberThe minimum level of details for the tiles
source-systemstringInitial data coordinate system
source-tileheightnumberHeight for the tiles to use (in px)
source-tilewidthnumberWidth for the tiles to use (in px)
source-tokenstringAuthorization token (for ArcGIS tile servers if needed)
source-urlstringData server url
systemGeodeticSystemCoordinate system this layer's data is in
systemstringInitial data coordinate system
taganyCustom information associated with node. It is a user object which can be used by client code to store information or attach an application object to the shape
tileheightnumberHeight for the tiles to use (in px)
tilewidthnumberWidth for the tiles to use (in px)
tokenstringAuthorization token (for ArcGIS tile servers if needed)
urlstringServer url
urlstringData server url
visiblebooleanVisibility of the node, a boolean to determine if the node should be rendered or not
z-indexnumberDefine node z-index

Contents

Constructors

new Bing(options)

new Bing(options?)

Parameters

Name Type
Optional optionsOptions

Overrides

Tile.constructor

Methods

addCssClass

addCssClass(cssclass): Bing

Adds new css class to node

Parameters

Name Type Description
cssclassstring | string[]css class name('s)

Returns

Bing

this

Inherited from

Tile.addCssClass


addInvalidateHandler

addInvalidateHandler(handler): Bing

Add invalidate handler

Deprecated

since 4.0, use Node.on instead

Parameters

Name Type Description
handlerFunctionhandler to be notified about invalidation

Returns

Bing

this

Inherited from

Tile.addInvalidateHandler


calculateDefaultModelLimits

Protected calculateDefaultModelLimits(data?): Rect

Returns default model limits (based on the map coordinate system)

Parameters

Name Type Description
Optional dataAbstractFeature[] | Iterator<AbstractFeature>feature data changed (for feature layers), nothing otherwise

Returns

Rect

Inherited from

Tile.calculateDefaultModelLimits


checkCollision

checkCollision(context): boolean

Check if this node is within the area being rendered by the context

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

boolean

true if object is inside of renderable area

Inherited from

Tile.checkCollision


clearCache

clearCache(): Bing

Clear cache

Returns

Bing

this

Inherited from

Tile.clearCache


clone

clone(): Node

All subclasses should override copyConstructor or provide custom implementation for this method

Returns

Node

clone

Inherited from

Tile.clone


connectStyle

connectStyle(style, type, callback): Bing

Connects style.

This convenience method subscribes a listener to given style for the specified type.
And automatically un-subscribes listener if node is disposed to prevent memory leaks

Parameters

Name Type Description
styleEventDispatcherconnect style
typestringtype of event or property
callbackAttributeCallback<EventDispatcher>function to be called

Returns

Bing

this

Inherited from

Tile.connectStyle


copyConstructor

Protected copyConstructor(src, deepCopy?): Bing

Copy constructor function.
Function used as part of the cloning mechanism.
Implementations should copy the given instance state to this instance.

Parameters

Name Type Description
srcAbstractLayerSource to copy from
Optional deepCopybooleandeep copy

Returns

Bing

this

Inherited from

Tile.copyConstructor


disconnectStyle

disconnectStyle(style, type, callback): Bing

Disconnect style
This convenience method un-subscribes a listener to given style for the specified type.

Parameters

Name Type Description
styleEventDispatcherconnect style
typestringtype of event or property
callbackAttributeCallback<EventDispatcher>function to be called

Returns

Bing

this

Inherited from

Tile.disconnectStyle


dispose

dispose(): void

Disposes this layer, once disposed it should not be used anymore.

Returns

void

Inherited from

Tile.dispose


enableEventPropagation

enableEventPropagation(enable): Bing

Enable event propagation from the node hierarchy from bottom to top

This option is similar to DOM Event bubbling, which allows to get any event from child node. By default it is disabled for better performance.

Example

import {Group} from '@int/geotoolkit/scene/Group';
import {Events as SceneEvents} from '@int/geotoolkit/scene/Node';
const parentGroup = new Group()
.setName('ParentGroup')
.enableEventPropagation(true);
const childGroup = new Group()
.setName('ChildGroup');

parentGroup.addChild(childGroup);
parentGroup.on(SceneEvents.Invalidate, (eventName, sender, args) => {
// Got notifications from all children of parent group
});
childGroup.invalidate();

Parameters

Name Type Description
enablebooleanenable

Returns

Bing

this

Inherited from

Tile.enableEventPropagation


execute

execute(delegate): Bing

Executes delegate and return the result. It allows us to keep all initialization calls in one place,
and we do not need to scroll up or down in IDE to find how and where it was initialized.

Example

// All setters (.setName() for example) returns reference to the this.
// In order to modify inner object like LineStyle or Pattern, to get this object (property) we should call getter to get object reference.
// Then modify it as shown below in Option 1 or you can use execute methods shown in Option 2.
import {Group} from '@int/geotoolkit/scene/Group';
import {Rect} from '@int/geotoolkit/util/Rect';
// Option 1
const group = new Group()
.setName('MyGroup')
.setBounds(new Rect(0, 0, 42, 16))
.enableClipping(true)
.setTag({'type': 'sometype'});

group.getLineStyle().setPattern('pattern');
return group;

// Options 2 ( using execute method )
return group
.execute(function () {
this.getLineStyle()
.setPattern("pattern");
});

Parameters

Name Type Description
delegate(this: Bing) => voidFunction to execute

Returns

Bing

The result if any or this

Inherited from

Tile.execute

execute<T>(delegate): T

Type parameters

Name
T

Parameters

Name Type
delegate(this: Bing) => T

Returns

T

Inherited from

Tile.execute


getCache

getCache(): Cache

Return cache strategy to be used to cache children nodes

Returns

Cache

cache cache strategy

Inherited from

Tile.getCache


getClassName

getClassName(): string

Returns

string

Inherited from

Tile.getClassName


getCoordinateSystem

getCoordinateSystem(): AbstractSystem

Return coordinate system for this layer

Returns

AbstractSystem

Inherited from

Tile.getCoordinateSystem


getCssClass

getCssClass(): string

Returns css class name to be used to apply CSS style

Returns

string

the css class name

Inherited from

Tile.getCssClass


getCssClasses

getCssClasses(): string[]

Gets list of css class names which applied to this node

Returns

string[]

Inherited from

Tile.getCssClasses


getDataSource

getDataSource(): AbstractSource

Returns current data source

Returns

AbstractSource

source

Inherited from

Tile.getDataSource


getDefaultModelLimits

getDefaultModelLimits(): Rect

Gets calculated model limits

Returns

Rect

limits calculated model limits

Inherited from

Tile.getDefaultModelLimits


getId

getId(): string | number

Returns the associated identifier of the node

Returns

string | number

The node's id

Inherited from

Tile.getId


getImageFormatter

getImageFormatter(): FormatterCallback

Gets the current formatter function if the function format is used

Returns

FormatterCallback

Inherited from

Tile.getImageFormatter


getLayerAlpha

getLayerAlpha(): number

Return a the alpha of the layer between 0.0 (fully transparent) and 1.0 (fully opaque). The default value is 1.0.

Returns

number

alpha alpha

Inherited from

Tile.getLayerAlpha


getMapCoordinateSystem

getMapCoordinateSystem(): AbstractSystem

Return a map coordinate system

Returns

AbstractSystem

Inherited from

Tile.getMapCoordinateSystem


getMaxLod

getMaxLod(): number

Gets the maximum Lod for the server

Returns

number

Inherited from

Tile.getMaxLod


getMinLod

getMinLod(): number

Gets the minimum Lod for the server

Returns

number

Inherited from

Tile.getMinLod


getModelLimits

getModelLimits(): Rect

Gets user defined model limits if set; calculated model limits otherwise

Returns

Rect

limits user defined or calculated model limits

Inherited from

Tile.getModelLimits


getName

getName(): string

Returns the node name

Returns

string

The node name

Inherited from

Tile.getName


getOptions

getOptions(): Options

Gets options

Returns

Options

options options

Inherited from

Tile.getOptions


getParent

getParent(): Node

Return parent node

Returns

Node

parent node

Inherited from

Tile.getParent


getProperties

getProperties(): OptionsOut

Gets all the properties pertaining to this object

Returns

OptionsOut

properties

Inherited from

Tile.getProperties


getProperty

getProperty(name): any

Gets dynamic property by name. These properties can be used as a property bags

Parameters

Name Type Description
namestringproperty name

Returns

any

Inherited from

Tile.getProperty


getPropertyKeys

getPropertyKeys(): string[]

Returns known properties keys

Returns

string[]

Inherited from

Tile.getPropertyKeys


getRoot

getRoot(): Node

Returns root node.
If node doesn't have parent then it returns itself.

Returns

Node

the root node

Inherited from

Tile.getRoot


getSceneTransform

getSceneTransform(): Transformation

Returns transformation from node to root scene

Returns

Transformation

a transformation from node to root scene

Inherited from

Tile.getSceneTransform


getServerURL

getServerURL(): string | string[]

Gets the server url from the layer source

Returns

string | string[]

Inherited from

Tile.getServerURL


getTag

getTag(): any

Returns the object associated with the node by user.

Returns

any

The node's user-object

Inherited from

Tile.getTag


getTileResolution

getTileResolution(): Dimension

Returns current tile resolution (in px)

Returns

Dimension

Inherited from

Tile.getTileResolution


getTooltipFormatter

getTooltipFormatter(): Formatter

Returns the format function to use for the tooltip info (null if tooltips are not visible)

Returns

Formatter

Inherited from

Tile.getTooltipFormatter


getVisible

getVisible(): boolean

Return visibility of the node

Returns

boolean

true if node is visible

Inherited from

Tile.getVisible


getVisibleModelLimits

getVisibleModelLimits(ignoreModelLimits?): Rect

Return visible model limits

Parameters

Name Type Description
Optional ignoreModelLimitsbooleanflag defines whether to ignore ModelLimits or not

Returns

Rect

Inherited from

Tile.getVisibleModelLimits


getWorldTransform

getWorldTransform(): Transformation

getWorldTransform retrieves the local transformation of the inner node coordinates to parent coordinates.

Returns

Transformation

the world transform.

Inherited from

Tile.getWorldTransform


getZIndex

getZIndex(): number

Returns node z-index (null if not set)

Returns

number

Inherited from

Tile.getZIndex


getZoomLevel

getZoomLevel(): number

Gets map zoom level

Returns

number

Inherited from

Tile.getZoomLevel


hasCssClass

hasCssClass(cssClass): boolean

Check if node has specified css class

Parameters

Name Type Description
cssClassstringcss class name

Returns

boolean

Inherited from

Tile.hasCssClass


hasEventListener

hasEventListener(type, callback?): boolean

Check if a list of event listeners for this type contains this listener

Parameters

Name Type Description
typestringtype of event or property
Optional callbackFunctionto be called, if null, check if any callback is registered

Returns

boolean

Inherited from

Tile.hasEventListener


hitTest

hitTest(pt, radius?): (AbstractNode | AbstractFeature)[]

Performs selection of the data with its device coordinates. Returns null, if no data available but will be loaded asynchronously later (fires Events.InfoUpdated).

Parameters

Name Type Description
ptPointis the device coordinates to select
Optional radiusnumberthe radius of selection (in px)

Returns

(AbstractNode | AbstractFeature)[]

data data selected

Inherited from

Tile.hitTest


invalidate

invalidate(bounds?, force?): Bing

Invalidate layer

Parameters

Name Type Description
Optional boundsRectbounds of the invalid rectangle in the inner node coordinates
Optional forcebooleantrue if parent should be invalidated immediately if null is provided then cache (if any will be completely refreshed) otherwise only specified rect or node.bounds will be refreshed

Returns

Bing

this

Inherited from

Tile.invalidate


invalidateParent

Protected invalidateParent(bounds?, force?): Bing

Invalidate parent and notify all listeners. NOTE: Don't keep arguments of the event, because instance can be changed

Fires

Events.Invalidate

Parameters

Name Type Description
Optional boundsRectbounds of the invalid rectangle in the inner node coordinates
Optional forcebooleanforce rendering

Returns

Bing

this

Inherited from

Tile.invalidateParent


isDisposed

isDisposed(): boolean

Returns whether this object has been disposed

Returns

boolean

Inherited from

Tile.isDisposed


isEventPropagationEnabled

isEventPropagationEnabled(): boolean

Return true if event propagation is enabled from child to parent

Returns

boolean

Inherited from

Tile.isEventPropagationEnabled


isLoading

isLoading(): boolean

Checks if layer data is still loading and not ready

Returns

boolean

Inherited from

Tile.isLoading


isNotificationEnabled

isNotificationEnabled(): boolean

return state of notification

Returns

boolean

current notification state

Inherited from

Tile.isNotificationEnabled


isSelectable

isSelectable(): boolean

Returns true if node can be picked/selected.

Returns

boolean

The selectable flag

Inherited from

Tile.isSelectable


isSilent

isSilent(): boolean

Return true if the event dispatcher doesn't notify any events

Returns

boolean

Inherited from

Tile.isSilent


load

load(): Promise<Bing>

Returns promise that is resolved when all layer data is loaded and ready to be rendered

Returns

Promise<Bing>

Inherited from

Tile.load


notify

notify<E>(type, source, args?): Bing

Notify listeners of the Node

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEtype of event
sourceAbstractLayersource who called the event
Optional argsEventMap[E]event arguments

Returns

Bing

this

Inherited from

Tile.notify


off

off<E>(type?, callback?): Bing

Detach listener on event. Calling .off() with no arguments removes all attached listeners. Calling .off(type) with no callback removes all attached listeners for specific type.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
Optional typeEtype of the event
Optional callback(eventType: E, sender: Bing, args: EventMap[E]) => voidfunction to be called

Returns

Bing

this

Inherited from

Tile.off


on

on<E>(type, callback): Bing

Attach listener on event that will be called whenever the specified event is delivered to the target

If the callback function is already in the list of event listeners for this target, the function is not added a second time.

If a particular anonymous function is in the list of event listeners registered for a certain target, and then later in the code, an identical anonymous function is given in an "on" call, the second function will also be added to the list of event listeners for that target.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEtype of event or property
callback(eventType: E, sender: Bing, args: EventMap[E]) => voidto be called

Returns

Bing

this

Inherited from

Tile.on


onParentChanged

Protected onParentChanged(node): Bing

This method is called when parent changes. Do not call it directly.

Parameters

Name Type Description
nodeNodenode to change parent

Returns

Bing

this

Inherited from

Tile.onParentChanged


onVisibilityChanged

Protected onVisibilityChanged(): void

This method is called if visibility is changed. Send event Events.VisibilityChanged

Returns

void

Inherited from

Tile.onVisibilityChanged


removeCssClass

removeCssClass(cssclass): Bing

Removes css class from node

Parameters

Name Type Description
cssclassstring | string[]css class name('s)

Returns

Bing

this

Inherited from

Tile.removeCssClass


removeInvalidateHandler

removeInvalidateHandler(handler): Bing

Remove invalidate handler

Deprecated

since 4.0, use Node.off instead

Parameters

Name Type Description
handlerFunctionhandler to be notified about invalidation

Returns

Bing

this

Inherited from

Tile.removeInvalidateHandler


render

render(context): void

Renders node

Parameters

Name Type Description
contextRenderingContextThe rendering context to be used to draw the node

Returns

void

Inherited from

Tile.render


renderAsync

renderAsync(context, callback): void

Render node in asynchronous mode. Default implementation creates call method "render" inside

Parameters

Name Type Description
contextRenderingContextThe rendering context to be used to draw the node
callback() => voidcallback function

Returns

void

Inherited from

Tile.renderAsync


renderContent

renderContent(context): void

Renders layer content

Parameters

Name Type Description
contextRenderingContextrendering context

Returns

void

Inherited from

Tile.renderContent


renderContentAsync

renderContentAsync(context, callback): void

Renders async layer content

Parameters

Name Type Description
contextRenderingContextthe Rendering Context
callback() => voidcallback to be called after rendering of layer content

Returns

void

Inherited from

Tile.renderContentAsync


setCache

setCache(cache): Bing

Sets cache to be used to cache

Parameters

Name Type Description
cacheCachecache to be used

Returns

Bing

this

Inherited from

Tile.setCache


setCssClass

setCssClass(name): Bing

Sets css class name of the node to be used to apply CSS style

Parameters

Name Type Description
namestringcss class name of the node

Returns

Bing

this

Inherited from

Tile.setCssClass


setId

setId(id): Bing

Allows the user to associate any identifier

Parameters

Name Type Description
idstring | numberobject id

Returns

Bing

this

Inherited from

Tile.setId


setImageFormatter

setImageFormatter(formatter): Bing

Sets image format for the server This converts the z, x, y image indexes into a path that is added to the server param to locate the requested tile.

Parameters

Name Type Description
formatterFormatterCallbackimage formatter

Returns

Bing

this

Inherited from

Tile.setImageFormatter


setLayerAlpha

setLayerAlpha(alpha): Bing

Set the alpha of the layer

Parameters

Name Type Description
alphanumberbetween 0.0 (fully transparent) and 1.0 (fully opaque). The default value is 1.0.

Returns

Bing

this

Inherited from

Tile.setLayerAlpha


setLods

setLods(min, max): Bing

Sets the min/max numbers of details for the server

Parameters

Name Type Description
minnumberminimum Lod
maxnumbermaximum Lod

Returns

Bing

this

Inherited from

Tile.setLods


setMapCoordinateSystem

setMapCoordinateSystem(system?): Bing

Sets a map coordinate system

Parameters

Name Type Description
Optional systemnumber | AbstractSystem | GeodeticSystemnew map coordinate system

Returns

Bing

Inherited from

Tile.setMapCoordinateSystem


setModelLimits

setModelLimits(limits): Bing

Sets model limits

Parameters

Name Type Description
limitsRectnew model limits

Returns

Bing

this

Inherited from

Tile.setModelLimits


setName

setName(name): Bing

Sets name of the node

Parameters

Name Type Description
namestringThe node name

Returns

Bing

this

Inherited from

Tile.setName


setNotification

setNotification(notify, force?): Bing

set notification state

Parameters

Name Type Description
notifybooleanflag set to invalidate parent or not
Optional forcebooleantrue if parent should be invalidated immediately

Returns

Bing

this

Inherited from

Tile.setNotification


setOptions

setOptions(options?): Bing

Sets options (default options listed are for construction time only)

Parameters

Name Type Description
Optional optionsOptionsBaseoptions

Returns

Bing

Inherited from

Tile.setOptions


setProperties

setProperties(properties?): Bing

Sets all the properties pertaining to this object

Parameters

Name Type Description
Optional propertiesOptionsoptions

Returns

Bing

this

Inherited from

Tile.setProperties


setProperty

setProperty(name, value): Bing

Sets dynamic property by name

Parameters

Name Type Description
namestringproperty name
valueanyproperty value

Returns

Bing

this

Inherited from

Tile.setProperty


setSelectable

setSelectable(selectable): Bing

Allows to select node. If node is not selectable then child node is not selectable.

Parameters

Name Type Description
selectablebooleanflag to allow node selection

Returns

Bing

this

Inherited from

Tile.setSelectable


setServerURL

setServerURL(url): Bing

Sets the url to the layer source

Parameters

Name Type Description
urlstring | string[]server url

Returns

Bing

Inherited from

Tile.setServerURL


setSilent

setSilent(bool): Bing

Set silent mode

Parameters

Name Type Description
boolbooleanflag to enable silent mode

Returns

Bing

this

Inherited from

Tile.setSilent


setTag

setTag(tag): Bing

Allows the user to associate any arbitrary object with the node.

Parameters

Name Type Description
taganyThe object to be associated with the node.

Returns

Bing

this

Inherited from

Tile.setTag


setTileResolution

setTileResolution(width, height): Bing

Sets the resolution of the tiles from the server

Parameters

Name Type Description
widthnumbertile width (in px)
heightnumbertile height (in px)

Returns

Bing

this

Inherited from

Tile.setTileResolution


setVisible

setVisible(value): Bing

Sets visibility of the node. Send event Events.VisibilityChanged

Parameters

Name Type Description
valuebooleanflag specifying visibility of the node

Returns

Bing

this

Inherited from

Tile.setVisible


setZIndex

setZIndex(value): Bing

Sets z-index for node (set null for default)

Parameters

Name Type Description
valuenumberindex determining node z-position

Returns

Bing

this

Inherited from

Tile.setZIndex


toString

toString(): string

Returns a string representation of this object (generally the classname)

Returns

string

A string representation

Inherited from

Tile.toString


transformFromMap

transformFromMap(point, dst?, clamp?): Point

Transform a point from map coordinate system to layer coordinate system

Parameters

Name Type Description
pointPointpoint to transform
Optional dstPointoptional destination point
Optional clampbooleanif set to true, coordinate values will be clamped

Returns

Point

Inherited from

Tile.transformFromMap


transformPoint

transformPoint(point, from, to, dst?, clamp?): Point

Transform point

Parameters

Name Type Description
pointPointpoint to transform
fromAbstractSystem | GeodeticSystemsystem converting from
toAbstractSystem | GeodeticSystemsystem converting to
Optional dstPointoptional destination point
Optional clampbooleanif set to true, coordinate values will be clamped

Returns

Point

Inherited from

Tile.transformPoint


transformToMap

transformToMap(point, dst?, clamp?): Point

Transform a point from layer coordinate system to map coordinate system

Parameters

Name Type Description
pointPointpoint to transform
Optional dstPointoptional destination point
Optional clampbooleanif set to true, coordinate values will be clamped

Returns

Point

Inherited from

Tile.transformToMap


updateSceneTransformation

updateSceneTransformation(): Bing

Update scene transformation

Returns

Bing

this

Inherited from

Tile.updateSceneTransformation


updateState

updateState(regions?, changes?): Bing

Update state. These methods reset node state and update state for children. this method is useful to refresh a scene graph

Parameters

Name Type Description
Optional regionsRect[]optional array to return invalid rectangles in the parent coordinates
Optional changesStateChangesoptional parameter to specify a reason of changes

Returns

Bing

this

Inherited from

Tile.updateState


updateTimeStamp

Protected updateTimeStamp(): Bing

Update time stamp to indicate that Node or Children has been changed.

Returns

Bing

this

Inherited from

Tile.updateTimeStamp


enableSceneGraphNotification

Static enableSceneGraphNotification(enabled): void

Enable / disable all notifications

Parameters

Name Type Description
enabledbooleansets if this object sends notifications

Returns

void

Inherited from

Tile.enableSceneGraphNotification


findParent

Static findParent<T>(node, classType, filter?): InstanceType<T>

Find root of the node with specified type

Type parameters

NameType
Textends Constructor<any>

Parameters

Name Type Description
nodeNodenode to start search
classTypeTtype of the class to search for
Optional filter(node: Node) => booleanadditional filter to apply

Returns

InstanceType<T>

Inherited from

Tile.findParent

Static findParent(node, classType, filter?): Node

Find root of the node with specified type

Parameters

Name Type Description
nodeNodenode to start search
classTypestringinterface name to search for
Optional filter(node: Node) => booleanadditional filter to apply

Returns

Node

Inherited from

Tile.findParent


getClassName

Static getClassName(): string

Returns

string

Inherited from

Tile.getClassName


isSceneGraphNotificationEnabled

Static isSceneGraphNotificationEnabled(): boolean

Return status of the global notification for all nodes.

Returns

boolean

Inherited from

Tile.isSceneGraphNotificationEnabled