Class MultiPolygon

Classdesc

Multi-polygon geometry.

Api

Hierarchy (view full)

Constructors

constructor

Properties

disposed flatCoordinates layout on once simplifiedGeometryMaxMinSquaredTolerance simplifiedGeometryRevision simplifyTransformedInternal stride un

Methods

addChangeListener addEventListener appendPolygon applyProperties applyTransform changed clone closestPointXY computeExtent containsXY dispatchEvent dispose disposeInternal get getArea getClosestPoint getCoordinates getEndss getExtent getFirstCoordinate getFlatCoordinates getFlatInteriorPoints getInteriorPoints getKeys getLastCoordinate getLayout getListeners getOrientedFlatCoordinates getPolygon getPolygons getProperties getPropertiesInternal getRevision getSimplifiedGeometry getSimplifiedGeometryInternal getStride getType hasListener hasProperties intersectsCoordinate intersectsExtent notify onceInternal onInternal removeChangeListener removeEventListener rotate scale set setCoordinates setFlatCoordinates setLayout setProperties simplify simplifyTransformed transform translate unInternal unset

Constructors

constructor

  • new MultiPolygon(coordinates, layout?, endss?): MultiPolygon

  • Parameters

    • coordinates: number[] | (Polygon | Coordinate[][])[]

      Coordinates. For internal use, flat coordinates in combination with layout and endss are also accepted.

    • Optionallayout: GeometryLayout

      Layout.

    • Optionalendss: number[][]

      Array of ends for internal use with flat coordinates.

    Returns MultiPolygon

Properties

Protecteddisposed

disposed: boolean

The object has already been disposed.

ProtectedflatCoordinates

flatCoordinates: number[]

Protectedlayout

layout: GeometryLayout

on

on: ObjectOnSignature<EventsKey>

once

once: ObjectOnSignature<EventsKey>

ProtectedsimplifiedGeometryMaxMinSquaredTolerance

simplifiedGeometryMaxMinSquaredTolerance: number

ProtectedsimplifiedGeometryRevision

simplifiedGeometryRevision: number

AbstractsimplifyTransformedInternal

simplifyTransformedInternal: ((...arg0: any[]) => Geometry)

Get a transformed and simplified version of the geometry.

Type declaration

    • (...arg0): Geometry

    • Parameters

      • Rest...arg0: any[]

      Returns Geometry

      Simplified geometry.

Protectedstride

stride: number

un

un: ObjectOnSignature<void>

Methods

addChangeListener

  • addChangeListener(key, listener): void

  • Parameters

    • key: string

      Key name.

    • listener: Listener

      Listener.

    Returns void

addEventListener

  • addEventListener(type, listener): void

  • Parameters

    • type: string

      Type.

    • listener: Listener

      Listener.

    Returns void

appendPolygon

  • appendPolygon(polygon): void

  • Append the passed polygon to this multipolygon.

    Parameters

    Returns void

    Api

ProtectedapplyProperties

  • applyProperties(source): void
  • Protected

    Apply any properties from another object without triggering events.

    Parameters

    • source: Object

      The source object.

    Returns void

AbstractapplyTransform

  • applyTransform(transformFn): void

  • Apply a transform function to the coordinates of the geometry. The geometry is modified in place. If you do not want the geometry modified in place, first clone() it and then use this function on the clone.

    Parameters

    • transformFn: TransformFunction

      Transform function. Called with a flat array of geometry coordinates.

    Returns void

changed

  • changed(): void

  • Increases the revision counter and dispatches a 'change' event.

    Returns void

    Api

clone

AbstractclosestPointXY

  • closestPointXY(x, y, closestPoint, minSquaredDistance): number

  • Parameters

    • x: number

      X.

    • y: number

      Y.

    • closestPoint: Coordinate

      Closest point.

    • minSquaredDistance: number

      Minimum squared distance.

    Returns number

    Minimum squared distance.

Protected AbstractcomputeExtent

  • computeExtent(extent): Extent
  • Protected

    Parameters

    • extent: Extent

      Extent.

    Returns Extent

    extent Extent.

containsXY

  • containsXY(x, y): boolean

  • Parameters

    • x: number

      X.

    • y: number

      Y.

    Returns boolean

    Contains (x, y).

dispatchEvent

  • dispatchEvent(event): undefined | boolean

  • Dispatches an event and calls all listeners listening for events of this type. The event parameter can either be a string or an Object with a type property.

    Parameters

    • event: string | BaseEvent

      Event object.

    Returns undefined | boolean

    false if anyone called preventDefault on the event object or if any of the listeners returned false.

    Api

dispose

  • dispose(): void

  • Clean up.

    Returns void

ProtecteddisposeInternal

  • disposeInternal(): void
  • Protected

    Extension point for disposable objects.

    Returns void

get

  • get(key): any

  • Gets a value.

    Parameters

    • key: string

      Key name.

    Returns any

    Value.

    Api

getArea

  • getArea(): number

  • Return the area of the multipolygon on projected plane.

    Returns number

    Area (on projected plane).

    Api

getClosestPoint

  • getClosestPoint(point, closestPoint?): Coordinate

  • Return the closest point of the geometry to the passed point as module:ol/coordinate~Coordinate coordinate.

    Parameters

    • point: Coordinate

      Point.

    • OptionalclosestPoint: Coordinate

      Closest point.

    Returns Coordinate

    Closest point.

    Api

getCoordinates

  • getCoordinates(right?): Coordinate[][][]

  • Get the coordinate array for this geometry. This array has the structure of a GeoJSON coordinate array for multi-polygons.

    Parameters

    • Optionalright: boolean

      Orient coordinates according to the right-hand rule (counter-clockwise for exterior and clockwise for interior rings). If false, coordinates will be oriented according to the left-hand rule (clockwise for exterior and counter-clockwise for interior rings). By default, coordinate orientation will depend on how the geometry was constructed.

    Returns Coordinate[][][]

    Coordinates.

    Api

getEndss

  • getEndss(): number[][]

  • Returns number[][]

    Endss.

getExtent

  • getExtent(extent?): Extent

  • Get the extent of the geometry.

    Parameters

    • Optionalextent: Extent

      Extent.

    Returns Extent

    extent Extent.

    Api

getFirstCoordinate

  • getFirstCoordinate(): Coordinate

  • Return the first coordinate of the geometry.

    Returns Coordinate

    First coordinate.

    Api

getFlatCoordinates

  • getFlatCoordinates(): number[]

  • Returns number[]

    Flat coordinates.

getFlatInteriorPoints

  • getFlatInteriorPoints(): number[]

  • Returns number[]

    Flat interior points.

getInteriorPoints

  • getInteriorPoints(): MultiPoint

  • Return the interior points as module:ol/geom/MultiPoint~MultiPoint multipoint.

    Returns MultiPoint

    Interior points as XYM coordinates, where M is the length of the horizontal intersection that the point belongs to.

    Api

getKeys

  • getKeys(): string[]

  • Get a list of object property names.

    Returns string[]

    List of property names.

    Api

getLastCoordinate

  • getLastCoordinate(): Coordinate

  • Return the last coordinate of the geometry.

    Returns Coordinate

    Last point.

    Api

getLayout

  • getLayout(): GeometryLayout

  • Return the import("./Geometry.js").GeometryLayout layout of the geometry.

    Returns GeometryLayout

    Layout.

    Api

getListeners

  • getListeners(type): undefined | Listener[]

  • Get the listeners for a specified event type. Listeners are returned in the order that they will be called in.

    Parameters

    • type: string

      Type.

    Returns undefined | Listener[]

    Listeners.

getOrientedFlatCoordinates

  • getOrientedFlatCoordinates(): number[]

  • Returns number[]

    Oriented flat coordinates.

getPolygon

  • getPolygon(index): Polygon

  • Return the polygon at the specified index.

    Parameters

    • index: number

      Index.

    Returns Polygon

    Polygon.

    Api

getPolygons

  • getPolygons(): Polygon[]

  • Return the polygons of this multipolygon.

    Returns Polygon[]

    Polygons.

    Api

getProperties

  • getProperties(): {
        [x: string]: any;
    }

  • Get an object of all property names and values.

    Returns {
        [x: string]: any;
    }

    Object.

    • [x: string]: any

    Api

getPropertiesInternal

  • getPropertiesInternal(): null | {
        [x: string]: any;
    }

  • Get an object of all property names and values.

    Returns null | {
        [x: string]: any;
    }

    Object.

getRevision

  • getRevision(): number

  • Get the version number for this object. Each time the object is modified, its version number will be incremented.

    Returns number

    Revision.

    Api

getSimplifiedGeometry

  • getSimplifiedGeometry(squaredTolerance): SimpleGeometry

  • Create a simplified version of this geometry using the Douglas Peucker algorithm.

    Parameters

    • squaredTolerance: number

      Squared tolerance.

    Returns SimpleGeometry

    Simplified geometry.

ProtectedgetSimplifiedGeometryInternal

getStride

  • getStride(): number

  • Returns number

    Stride.

AbstractgetType

  • getType(): Type

  • Get the type of this geometry.

    Returns Type

    Geometry type.

hasListener

  • hasListener(type?): boolean

  • Parameters

    • Optionaltype: string

      Type. If not provided, true will be returned if this event target has any listeners.

    Returns boolean

    Has listeners.

hasProperties

  • hasProperties(): boolean

  • Returns boolean

    The object has properties.

intersectsCoordinate

  • intersectsCoordinate(coordinate): boolean

  • Returns true if this geometry includes the specified coordinate. If the coordinate is on the boundary of the geometry, returns false.

    Parameters

    • coordinate: Coordinate

      Coordinate.

    Returns boolean

    Contains coordinate.

    Api

AbstractintersectsExtent

  • intersectsExtent(extent): boolean

  • Test if the geometry and the passed extent intersect.

    Parameters

    • extent: Extent

      Extent.

    Returns boolean

    true if the geometry and the extent intersect.

notify

  • notify(key, oldValue): void

  • Parameters

    • key: string

      Key name.

    • oldValue: any

      Old value.

    Returns void

ProtectedonceInternal

  • onceInternal(type, listener): EventsKey | EventsKey[]
  • Protected

    Parameters

    • type: string | string[]

      Type.

    • listener: ((arg0: Event | BaseEvent) => unknown)

      Listener.

        • (arg0): unknown

        • Parameters

          • arg0: Event | BaseEvent

          Returns unknown

    Returns EventsKey | EventsKey[]

    Event key.

ProtectedonInternal

  • onInternal(type, listener): EventsKey | EventsKey[]
  • Protected

    Parameters

    • type: string | string[]

      Type.

    • listener: ((arg0: Event | BaseEvent) => unknown)

      Listener.

        • (arg0): unknown

        • Parameters

          • arg0: Event | BaseEvent

          Returns unknown

    Returns EventsKey | EventsKey[]

    Event key.

removeChangeListener

  • removeChangeListener(key, listener): void

  • Parameters

    • key: string

      Key name.

    • listener: Listener

      Listener.

    Returns void

removeEventListener

  • removeEventListener(type, listener): void

  • Parameters

    • type: string

      Type.

    • listener: Listener

      Listener.

    Returns void

Abstractrotate

  • rotate(angle, anchor): void

  • Rotate the geometry around a given coordinate. This modifies the geometry coordinates in place.

    Parameters

    • angle: number

      Rotation angle in radians.

    • anchor: Coordinate

      The rotation center.

    Returns void

    Api

Abstractscale

  • scale(sx, sy?, anchor?): void

  • Scale the geometry (with an optional origin). This modifies the geometry coordinates in place.

    Parameters

    • sx: number

      The scaling factor in the x-direction.

    • Optionalsy: number

      The scaling factor in the y-direction (defaults to sx).

    • Optionalanchor: Coordinate

      The scale origin (defaults to the center of the geometry extent).

    Returns void

    Api

set

  • set(key, value, silent?): void

  • Sets a value.

    Parameters

    • key: string

      Key name.

    • value: any

      Value.

    • Optionalsilent: boolean

      Update without triggering an event.

    Returns void

    Api

setCoordinates

  • setCoordinates(coordinates, layout?): void

  • Set the coordinates of the multipolygon.

    Parameters

    • coordinates: Coordinate[][][]

      Coordinates.

    • Optionallayout: GeometryLayout

      Layout.

    Returns void

    Api

setFlatCoordinates

  • setFlatCoordinates(layout, flatCoordinates): void

  • Parameters

    • layout: GeometryLayout

      Layout.

    • flatCoordinates: number[]

      Flat coordinates.

    Returns void

ProtectedsetLayout

  • setLayout(layout, coordinates, nesting): void
  • Protected

    Parameters

    • layout: undefined | GeometryLayout

      Layout.

    • coordinates: any[]

      Coordinates.

    • nesting: number

      Nesting.

    Returns void

setProperties

  • setProperties(values, silent?): void

  • Sets a collection of key-value pairs. Note that this changes any existing properties and adds new ones (it does not remove any existing properties).

    Parameters

    • values: {
          [x: string]: any;
      }

      Values.

      • [x: string]: any
    • Optionalsilent: boolean

      Update without triggering an event.

    Returns void

    Api

simplify

  • simplify(tolerance): Geometry

  • Create a simplified version of this geometry. For linestrings, this uses the Douglas Peucker algorithm. For polygons, a quantization-based simplification is used to preserve topology.

    Parameters

    • tolerance: number

      The tolerance distance for simplification.

    Returns Geometry

    A new, simplified version of the original geometry.

    Api

AbstractsimplifyTransformed

  • simplifyTransformed(squaredTolerance, transform?): Geometry

  • Get a transformed and simplified version of the geometry.

    Parameters

    • squaredTolerance: number

      Squared tolerance.

    • Optionaltransform: TransformFunction

      Optional transform function.

    Returns Geometry

    Simplified geometry.

transform

  • transform(source, destination): this

  • Transform each coordinate of the geometry from one coordinate reference system to another. The geometry is modified in place. For example, a line will be transformed to a line and a circle to a circle. If you do not want the geometry modified in place, first clone() it and then use this function on the clone.

    Parameters

    • source: ProjectionLike

      The current projection. Can be a string identifier or a module:ol/proj/Projection~Projection object.

    • destination: ProjectionLike

      The desired projection. Can be a string identifier or a module:ol/proj/Projection~Projection object.

    Returns this

    This geometry. Note that original geometry is modified in place.

    Api

Abstracttranslate

  • translate(deltaX, deltaY): void

  • Translate the geometry. This modifies the geometry coordinates in place. If instead you want a new geometry, first clone() this geometry.

    Parameters

    • deltaX: number

      Delta X.

    • deltaY: number

      Delta Y.

    Returns void

    Api

ProtectedunInternal

  • unInternal(type, listener): void
  • Protected

    Unlisten for a certain type of event.

    Parameters

    • type: string | string[]

      Type.

    • listener: ((arg0: Event | BaseEvent) => unknown)

      Listener.

        • (arg0): unknown

        • Parameters

          • arg0: Event | BaseEvent

          Returns unknown

    Returns void

unset

  • unset(key, silent?): void

  • Unsets a property.

    Parameters

    • key: string

      Key name.

    • Optionalsilent: boolean

      Unset without triggering an event.

    Returns void

    Api

Settings

Member Visibility

On This Page

Constructors
Properties
Methods