math module

Pakiet:

azure-maps-control

Klasy

AffineTransform

Klasa Przekształcenia Affine wygenerowana na podstawie zestawu punktów odniesienia.

Wyliczenia

AccelerationUnits	Jednostki miary przyspieszania.
AreaUnits	Jednostki miary dla obszarów.
DistanceUnits	Jednostki miary dla odległości.
SpeedUnits	Jednostki miary dla prędkości.
TimeUnits	Jednostki miary dla czasu.

Funkcje

boundingBoxToPolygon(BoundingBox)	Pobiera element BoundingBox i konwertuje go na wielokąt.
convertAcceleration(number, string | AccelerationUnits, string | AccelerationUnits, number)	Konwertuje wartość przyspieszenia z jednej jednostki na inną. Obsługiwane jednostki: milesPerSecondSquared, kilometryPerSecondSquared, meterPerSecondSquared, feetPerSecondSquared yardsPerSecondSquared, kilometryPerHoursSecond, milesPerHourSecond, węzłyPerSecond, standardGravity
convertArea(number, string, string, number)	Konwertuje wartość obszaru z jednej jednostki na inną. Obsługiwane jednostki: squareMeters, akrów, hektarów, squareFeet, squareYards, squareMiles, squareKilometers
convertDistance(number, string | DistanceUnits, string | DistanceUnits, number)	Konwertuje odległość od jednej jednostki odległości do innej. Obsługiwane jednostki: mile, morskieMiles, stocznie, mierniki, kilometry, stopy
convertSpeed(number, string | SpeedUnits, string | SpeedUnits, number)	Konwertuje wartość szybkości z jednej jednostki na inną. Obsługiwane jednostki: kmPerHour, milesPerHour, meterPerSecond, feetPerSecond, węzły, mach
convertTimespan(number, string | TimeUnits, string | TimeUnits, number)	Konwertuje wartość przedziału czasu z jednej jednostki na inną. Obsługiwane jednostki: ms (milisekundy), godziny, minuty, sekundy
getAcceleration(number, number, number, string | SpeedUnits, string | DistanceUnits, string | TimeUnits, string | AccelerationUnits, number)	Oblicza przyspieszenie na podstawie początkowej prędkości, odległości podróży i przedziału czasu. Formuła: a = 2*(d - v*t)/t^2
getAccelerationFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string, string | SpeedUnits, string | AccelerationUnits, number)	Oblicza przyspieszenie między dwiema funkcjami punktów, które mają właściwość znacznika czasu i opcjonalnie właściwość speed. Jeśli podano prędkości, zignoruj odległość między punktami, ponieważ ścieżka mogła nie być prosta i oblicz: a = (v2 - v1)/(t2 - t1), jeśli nie podano prędkości lub podano tylko w pierwszym punkcie, oblicz odległość linii prostej między punktami i oblicz: a = 2*(d - v*t)/t^2
getAccelerationFromSpeeds(number, number, number, string | SpeedUnits, string | TimeUnits, string | AccelerationUnits, number)	Oblicza przyspieszenie na podstawie szybkości początkowej, szybkości końcowej i przedziału czasu. Formuła: a = 2* (wersja 2 - v1)/t
getArea(atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, AreaUnits, number)	Oblicza przybliżony obszar geometrii w określonych jednostkach
getCardinalSpline(Position[], number, number, boolean)	Oblicza tablicę pozycji, które tworzą kardynaną krzywą między określoną tablicą pozycji.
getClosestPointOnGeometry(Position | Point | Feature<Point, any> | Shape, atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, string | DistanceUnits, number)	Oblicza najbliższy punkt na krawędzi geometrii do określonego punktu lub położenia. Funkcja zwracanego punktu będzie mieć właściwość określającą distance odległość między dwoma punktami w określonych jednostkach. Jeśli geometria jest punktem, pozycja punktów będzie używana dla wyniku. Jeśli geometria jest MultiPoint, odległości do poszczególnych pozycji będą używane. Jeśli geometria jest wielokątem lub wielobiegunem, punkt najbliżej dowolnej krawędzi zostanie zwrócony niezależnie od tego, czy punkt przecina geometrię, czy nie.
getConvexHull(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)	Oblicza kadłub wypukły na podstawie tablicy pozycji, geometrii lub cech.
getDestination(Position | Point, number, number, string | DistanceUnits)	Oblicza położenie docelowe na podstawie pozycji początkowej, nagłówka, odległości i typu jednostki odległości.
getDistanceTo(Position | Point, Position | Point, string | DistanceUnits)	Oblicz odległość między dwoma obiektami położenia na powierzchni ziemi przy użyciu formuły Haversine.
getEarthRadius(string | DistanceUnits)	Pobiera promień ziemi w określonej jednostce odległości dla usługi WGS84.
getGeodesicPath(LineString | Position[], number)	Przyjmuje tablicę obiektów pozycji i wypełnia przestrzeń między nimi z dokładnie rozmieszczonymi pozycjami, aby utworzyć przybliżoną ścieżkę geodesyjną.
getGeodesicPaths(LineString | Position[], number)	Przyjmuje tablicę obiektów pozycji i wypełnia przestrzeń między nimi z dokładnie rozmieszczonymi pozycjami, aby utworzyć przybliżoną ścieżkę geodesyjną przerwaną przez antymeryka do wielu ścieżek podrzędnych.
getHeading(Position | Point, Position | Point)	Oblicza nagłówek z jednego obiektu położenia do drugiego.
getLengthOfPath(LineString | Position[], string | DistanceUnits)	Oblicza odległość między wszystkimi obiektami położenia w tablicy.
getPathDenormalizedAtAntimerian(LineString | Position[])	Denormalizuje ścieżkę na antymerykanidzie, to sprawia, że linie ze współrzędnymi po przeciwnej stronie antymeryka, aby zawsze go przekraczać. Należy pamiętać, że ścieżka przechodząca przez antymeryka będzie zawierać długość geograficzną poza zakresem od -180 do 180. Jeśli nie jest to pożądane, zobacz getPathSplitByAntimeridian.
getPathSplitByAntimeridian(LineString | Position[])	Podziel ścieżkę na antymerykanie na wiele ścieżek. Jeśli nie jest to pożądane, zobacz getPathDenormalizedAtAntimerian.
getPixelHeading(Position | Point, Position | Point)	Oblicza dokładny nagłówek pikseli z jednej pozycji do innej w oparciu o projekcję mapy Mercator. Ten nagłówek jest wizualnie dokładny.
getPointsWithHeadingsAlongPath(LineString | Position[], number)	Pobiera tablicę równomiernie rozmieszczonych punktów z nagłówkami wzdłuż ścieżki.
getPointWithHeadingAlongPath(LineString | Position[], number, string | DistanceUnits)	Pobiera punkt z nagłówkiem określonej odległości wzdłuż ścieżki.
getPosition(Position | Point | Feature<Point, any> | Shape)	Pobiera położenie obiektu, który jest pozycją, punktem, funkcją punktu lub okręgiem. Jeśli jest to okrąg, zostanie zwrócona jego współrzędna środkowa.
getPositionAlongPath(LineString | Position[], number, string | DistanceUnits)	Oblicza obiekt położenia na ścieżce, która jest określoną odległością od początku ścieżki. Jeśli określona odległość jest dłuższa niż długość ścieżki, zostanie zwrócona ostatnia pozycja ścieżki.
getPositions(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)	Pobiera tablicę wszystkich pozycji w podanej geometrii, funkcji lub tablicy geometrii/cech.
getPositionsAlongPath(LineString | Position[], number)	Pobiera tablicę równomiernie rozmieszczonych pozycji wzdłuż ścieżki.
getRegularPolygonPath(Position | Point, number, number, string | DistanceUnits, number)	Oblicza tablicę obiektów położenia, które są równą odległością od punktu centralnego, aby utworzyć zwykły wielokąt.
getRegularPolygonPaths(Position | Point, number, number, string | DistanceUnits, number)	Oblicza tablicę obiektów położenia, które są równą odległością od punktu centralnego, aby utworzyć zwykły wielokąt podzielony przez antymerykad na wiele ścieżek podrzędnych.
getSpeed(Position | Point | Feature<Point, any>, Position | Point | Feature<Point, any>, number, string | TimeUnits, string | SpeedUnits, number)	Oblicza średnią prędkość podróży między dwoma punktami na podstawie podanego czasu.
getSpeedFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string | SpeedUnits, number)	Oblicza średnią prędkość podróży między dwoma cechami punktów, które mają właściwość zawierającą sygnaturę czasową. Sygnatura czasowa może być następująca: Obiekt Date języka JavaScript Liczba reprezentująca liczbę milisekund od 1 stycznia 1970 r. Ciąg, który używa jednego z następujących formatów: Format daty ISO8601 (tj. 2012-04-23T18:25:43.511Z) Składnia daty RFC282/ IETF (sekcja 3.3) Ciąg daty OData (tj. "/Date(1235764800000)/")
getTimespan(Date | string | number, Date | string | number, TimeUnits, number)	Oblicza przedział czasu między dwiema datami lub znacznikami czasu. Sygnatury czasowe mogą być następujące: Obiekt Date języka JavaScript Liczba reprezentująca liczbę milisekund od 1 stycznia 1970 r. Ciąg, który używa jednego z następujących formatów: Format daty ISO8601 (tj. 2012-04-23T18:25:43.511Z) Składnia daty RFC282/ IETF (sekcja 3.3) Ciąg daty OData (tj. "/Date(1235764800000)/")
getTravelDistance(string, number, number, number, string | TimeUnits, string | SpeedUnits, string, number)	Oblicza odległość podróżną dla określonego przedziału czasu, prędkości i opcjonalnie przyspieszenia. Formuła: d = vt + 0,5a*t^2
interpolate(Position | Point, Position | Point, number)	Oblicza obiekt położenia, który jest odległością ułamkową między dwoma obiektami położenia.
mercatorPixelsToPositions(Pixel[], number)	Konwertuje tablicę globalnych współrzędnych pikseli Mercatora na tablicę pozycji geoprzestrzennych na określonym poziomie powiększenia. Współrzędne globalne pikseli są względem lewego górnego rogu mapy [-180, 90].
mercatorPositionsToPixels(Position[], number)	Konwertuje tablicę pozycji na tablicę globalnych współrzędnych pikseli Mercator na określonym poziomie powiększenia.
normalizeLatitude(number)	Normalizuje wartość szerokości geograficznej z zakresu od -90 do 90 stopni.
normalizeLongitude(number)	Normalizuje wartość długości geograficznej z zakresu od -180 do 180 stopni.
parseTimestamp(Date | string | number)	Analizuje znacznik czasu w obiekcie Date języka JavaScript. Sygnatury czasowe mogą być następujące: Obiekt Date języka JavaScript Liczba reprezentująca liczbę milisekund od 1 stycznia 1970 r. Ciąg, który używa jednego z następujących formatów: Format daty ISO8601 (tj. 2012-04-23T18:25:43.511Z) Składnia daty RFC282/ IETF (sekcja 3.3) Ciąg daty OData (tj. "/Date(1235764800000)/")
rotatePositions(Position[], Position | Point, number)	Przyjmuje tablicę pozycji i obraca je wokół danej pozycji dla określonego kąta obrotu.
simplify((Position | Pixel)[], number)	Przeprowadź uproszczenie Douglas-Peucker na tablicy pozycji lub pikseli.

Szczegóły funkcji

boundingBoxToPolygon(BoundingBox)

Pobiera element BoundingBox i konwertuje go na wielokąt.

function boundingBoxToPolygon(bounds: BoundingBox): Polygon

Parametry

bounds

BoundingBox

Pole BoundingBox do konwersji na wielokąt.

Zwraca

Polygon

Reprezentacja wielokąta elementu BoundingBox.

convertAcceleration(number, string | AccelerationUnits, string | AccelerationUnits, number)

Konwertuje wartość przyspieszenia z jednej jednostki na inną. Obsługiwane jednostki: milesPerSecondSquared, kilometryPerSecondSquared, meterPerSecondSquared, feetPerSecondSquared yardsPerSecondSquared, kilometryPerHoursSecond, milesPerHourSecond, węzłyPerSecond, standardGravity

function convertAcceleration(acceleration: number, fromUnits: string | AccelerationUnits, toUnits: string | AccelerationUnits, decimals?: number): number

Parametry

acceleration

number

Wartość przyspieszenia do przekonwertowania.

fromUnits

string | AccelerationUnits

Jednostki przyspieszenia, w których znajduje się wartość.

toUnits

string | AccelerationUnits

Jednostki przyspieszania do konwersji na.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Wartość przyspieszenia została przeliczone z jednej jednostki do innej.

convertArea(number, string, string, number)

Konwertuje wartość obszaru z jednej jednostki na inną. Obsługiwane jednostki: squareMeters, akrów, hektarów, squareFeet, squareYards, squareMiles, squareKilometers

function convertArea(area: number, fromUnits: string, toUnits: string, decimals?: number): number

Parametry

area

number

Wartość obszaru do przekonwertowania.

fromUnits

string

Jednostki obszaru, w których znajduje się wartość.

toUnits

string

Jednostki obszaru do przekonwertowania na.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Wartość warstwowa została przeliczone z jednej jednostki do innej.

convertDistance(number, string | DistanceUnits, string | DistanceUnits, number)

Konwertuje odległość od jednej jednostki odległości do innej. Obsługiwane jednostki: mile, morskieMiles, stocznie, mierniki, kilometry, stopy

function convertDistance(distance: number, fromUnits: string | DistanceUnits, toUnits: string | DistanceUnits, decimals?: number): number

Parametry

distance

number

Liczba reprezentująca odległość do przekonwertowania.

fromUnits

string | DistanceUnits

Liczba jednostek odległości, w których znajduje się oryginalna odległość.

toUnits

string | DistanceUnits

Żądane jednostki odległości do przekonwertowania na.

decimals

number

Określa liczbę miejsc dziesiętnych, do których ma być zaokrąglany wynik. Jeśli nie zostanie zdefiniowana, nie nastąpi zaokrąglenie.

Zwraca

number

Odległość w nowych jednostkach.

convertSpeed(number, string | SpeedUnits, string | SpeedUnits, number)

Konwertuje wartość szybkości z jednej jednostki na inną. Obsługiwane jednostki: kmPerHour, milesPerHour, meterPerSecond, feetPerSecond, węzły, mach

function convertSpeed(speed: number, fromUnits: string | SpeedUnits, toUnits: string | SpeedUnits, decimals?: number): number

Parametry

speed

number

Wartość szybkości do przekonwertowania.

fromUnits

string | SpeedUnits

Jednostki prędkości, z których mają być konwertowane.

toUnits

string | SpeedUnits

Jednostki prędkości do konwersji na.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Wartość szybkości została przeliżowana z jednej jednostki na drugą.

convertTimespan(number, string | TimeUnits, string | TimeUnits, number)

Konwertuje wartość przedziału czasu z jednej jednostki na inną. Obsługiwane jednostki: ms (milisekundy), godziny, minuty, sekundy

function convertTimespan(timespan: number, fromUnits: string | TimeUnits, toUnits: string | TimeUnits, decimals?: number): number

Parametry

timespan

number

Wartość czasu do przekonwertowania.

fromUnits

string | TimeUnits

Jednostki czasu, z których mają być konwertowane.

toUnits

string | TimeUnits

Jednostki czasu, na które mają być konwertowane.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Wartość czasu została przeliczone z jednej jednostki do innej.

getAcceleration(number, number, number, string | SpeedUnits, string | DistanceUnits, string | TimeUnits, string | AccelerationUnits, number)

Oblicza przyspieszenie na podstawie początkowej prędkości, odległości podróży i przedziału czasu. Formuła: a = 2*(d - v*t)/t^2

function getAcceleration(initialSpeed: number, distance: number, timespan: number, speedUnits?: string | SpeedUnits, distanceUnits?: string | DistanceUnits, timeUnits?: string | TimeUnits, accelerationUnits?: string | AccelerationUnits, decimals?: number): number

Parametry

initialSpeed

number

Prędkość początkowa.

distance

number

Odległość, która została przejechana.

timespan

number

Przedział czasu, który podróżował.

speedUnits

string | SpeedUnits

Jednostki informacji o szybkości. Jeśli nie określono m/s, są używane.

distanceUnits

string | DistanceUnits

Jednostki informacji o odległości. Jeśli nie określono mierników, są używane.

timeUnits

string | TimeUnits

Jednostki informacji przedziału czasu. Jeśli nie określono sekund, są używane.

accelerationUnits

string | AccelerationUnits

Jednostki, w których mają być zwracane wartości przyspieszenia. Jeśli nie określono wartości m/s^2, są używane.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Przyspieszenie na podstawie początkowej prędkości, odległości podróży i przedziału czasu.

getAccelerationFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string, string | SpeedUnits, string | AccelerationUnits, number)

Oblicza przyspieszenie między dwiema funkcjami punktów, które mają właściwość znacznika czasu i opcjonalnie właściwość speed. Jeśli podano prędkości, zignoruj odległość między punktami, ponieważ ścieżka mogła nie być prosta i oblicz: a = (v2 - v1)/(t2 - t1), jeśli nie podano prędkości lub podano tylko w pierwszym punkcie, oblicz odległość linii prostej między punktami i oblicz: a = 2*(d - v*t)/t^2

function getAccelerationFromFeatures(origin: Feature<Point, any>, destination: Feature<Point, any>, timestampProperty: string, speedProperty?: string, speedUnits?: string | SpeedUnits, accelerationUnits?: string | AccelerationUnits, decimals?: number): number

Parametry

origin

Feature<Point, any>

Początkowy punkt, z którego jest obliczane przyspieszenie.

destination

Feature<Point, any>

Ostatni punkt, z którego jest obliczane przyspieszenie.

timestampProperty

string

Nazwa właściwości funkcji, która zawiera informacje o znaczniku czasu.

speedProperty

string

Nazwa właściwości funkcji, która zawiera informacje o szybkości.

speedUnits

string | SpeedUnits

Jednostki informacji o szybkości. Jeśli nie określono m/s jest używany.

accelerationUnits

string | AccelerationUnits

Jednostki, w których mają być zwracane wartości przyspieszenia. Jeśli nie określono wartości m/s^2, są używane.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Przyspieszenie między dwiema funkcjami punktów, które mają właściwość znacznika czasu i opcjonalnie właściwość speed. Zwraca wartość NaN, jeśli nie można przeanalizować znacznika czasu.

getAccelerationFromSpeeds(number, number, number, string | SpeedUnits, string | TimeUnits, string | AccelerationUnits, number)

Oblicza przyspieszenie na podstawie szybkości początkowej, szybkości końcowej i przedziału czasu. Formuła: a = 2* (wersja 2 - v1)/t

function getAccelerationFromSpeeds(initialSpeed: number, finalSpeed: number, timespan: number, speedUnits?: string | SpeedUnits, timeUnits?: string | TimeUnits, accelerationUnits?: string | AccelerationUnits, decimals?: number): number

Parametry

initialSpeed

number

Prędkość początkowa.

finalSpeed

number

Ostateczna prędkość.

timespan

number

Przedział czasu, który podróżował.

speedUnits

string | SpeedUnits

Jednostki informacji o szybkości. Jeśli nie określono mierników, są używane.

timeUnits

string | TimeUnits

Jednostki informacji przedziału czasu. Jeśli nie określono sekund, są używane.

accelerationUnits

string | AccelerationUnits

Jednostki, w których mają być zwracane wartości przyspieszenia. Jeśli nie określono wartości m/s^2, są używane.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Przyspieszenie na podstawie początkowej prędkości, prędkości końcowej i przedziału czasu.

getArea(atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, AreaUnits, number)

Oblicza przybliżony obszar geometrii w określonych jednostkach

function getArea(data: atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, areaUnits?: AreaUnits, decimals?: number): number

Parametry

data

Geometry | Feature<Geometry, any> | Shape

areaUnits

AreaUnits

Jednostka miary obszaru. Wartość domyślna to squareMeters.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Obszar geometrii w określonych jednostkach.

getCardinalSpline(Position[], number, number, boolean)

Oblicza tablicę pozycji, które tworzą kardynaną krzywą między określoną tablicą pozycji.

function getCardinalSpline(positions: Position[], tension?: number, nodeSize?: number, close?: boolean): Position[]

Parametry

positions

Position[]

Tablica pozycji do obliczenia krzywej przez.

tension

number

Liczba wskazująca szczelność krzywej. Może być dowolną liczbą, chociaż zwykle jest używana wartość z zakresu od 0 do 1. Ustawienie domyślne: 0,5

nodeSize

number

Liczba węzłów do wstawienia między poszczególnymi pozycjami. Ustawienie domyślne: 15

close

boolean

Wartość logiczna wskazująca, czy krzywa powinna być zamkniętym pierścieniem, czy nie. Wartość domyślna: false

Zwraca

Position[]

Tablica pozycji, które tworzą krzywą kardynaną między określoną tablicą pozycji.

getClosestPointOnGeometry(Position | Point | Feature<Point, any> | Shape, atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, string | DistanceUnits, number)

Oblicza najbliższy punkt na krawędzi geometrii do określonego punktu lub położenia. Funkcja zwracanego punktu będzie mieć właściwość określającą distance odległość między dwoma punktami w określonych jednostkach. Jeśli geometria jest punktem, pozycja punktów będzie używana dla wyniku. Jeśli geometria jest MultiPoint, odległości do poszczególnych pozycji będą używane. Jeśli geometria jest wielokątem lub wielobiegunem, punkt najbliżej dowolnej krawędzi zostanie zwrócony niezależnie od tego, czy punkt przecina geometrię, czy nie.

function getClosestPointOnGeometry(pt: Position | Point | Feature<Point, any> | Shape, geom: atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, units?: string | DistanceUnits, decimals?: number): Feature<Point, { distance: number }>

Parametry

pt

Position | Point | Feature<Point, any> | Shape

Punkt lub położenie, aby znaleźć najbliższy punkt na krawędzi geometrii.

geom

Geometry | Feature<Geometry, any> | Shape

Geometria znajdująca najbliższy punkt.

units

string | DistanceUnits

Jednostka miary odległości. Wartość domyślna to mierniki.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

Feature<Point, { distance: number }>

getConvexHull(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)

Oblicza kadłub wypukły na podstawie tablicy pozycji, geometrii lub cech.

function getConvexHull(data: Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape): Polygon

Parametry

data

Position[] | Geometry | Feature<Geometry, any> | FeatureCollection | GeometryCollection | Geometry[] | Array<Feature<Geometry, any> | Shape> | Shape

Tablica pozycji, geometrii lub cech do obliczenia wypukłego kadłuba.

Zwraca

Polygon

Kadłub wypukły z tablicy pozycji, geometrii lub cech.

getDestination(Position | Point, number, number, string | DistanceUnits)

Oblicza położenie docelowe na podstawie pozycji początkowej, nagłówka, odległości i typu jednostki odległości.

function getDestination(origin: Position | Point, heading: number, distance: number, units?: string | DistanceUnits): Position

Parametry

origin

Position | Point

Pozycja, z którą jest względna lokalizacja docelowa.

heading

number

Kąt nagłówka z zakresu od 0 do 360 stopni. 0 - Północ, 90 - Wschód, 180 - Południe, 270 - Zachód.

distance

number

Odległość od miejsca docelowego.

units

string | DistanceUnits

Jednostka miary odległości. Wartość domyślna to mierniki.

Zwraca

Position

Pozycja, która jest określoną odległością od punktu początkowego.

getDistanceTo(Position | Point, Position | Point, string | DistanceUnits)

Oblicz odległość między dwoma obiektami położenia na powierzchni ziemi przy użyciu formuły Haversine.

function getDistanceTo(origin: Position | Point, destination: Position | Point, units?: string | DistanceUnits): number

Parametry

origin

Position | Point

Pierwsza pozycja do obliczenia odległości między.

destination

Position | Point

Drugie położenie do obliczenia odległości między.

units

string | DistanceUnits

Jednostka miary odległości. Wartość domyślna to mierniki.

Zwraca

number

Najkrótsza odległość między dwoma pozycjami w określonych jednostkach.

getEarthRadius(string | DistanceUnits)

Pobiera promień ziemi w określonej jednostce odległości dla usługi WGS84.

function getEarthRadius(units?: string | DistanceUnits): number

Parametry

units

string | DistanceUnits

Jednostka miary odległości. Ustawienie domyślne: mierniki

Zwraca

number

Liczba reprezentująca promień ziemi w określonej jednostce odległości.

getGeodesicPath(LineString | Position[], number)

Przyjmuje tablicę obiektów pozycji i wypełnia przestrzeń między nimi z dokładnie rozmieszczonymi pozycjami, aby utworzyć przybliżoną ścieżkę geodesyjną.

function getGeodesicPath(path: LineString | Position[], nodeSize?: number): Position[]

Parametry

path

LineString | Position[]

Tablica obiektów położenia, które tworzą ścieżkę do wypełnienia.

nodeSize

number

Liczba węzłów do wstawienia między poszczególnymi pozycjami. Ustawienie domyślne: 15

Zwraca

Position[]

Tablica obiektów położenia, które tworzą ścieżki geodesowe, ścieżka geodesyczna przekraczająca antymerykad będzie zawierać długość geograficzną poza zakresem od -180 do 180. Zobacz getGeodesicPaths(), gdy jest to niepożądane.

getGeodesicPaths(LineString | Position[], number)

Przyjmuje tablicę obiektów pozycji i wypełnia przestrzeń między nimi z dokładnie rozmieszczonymi pozycjami, aby utworzyć przybliżoną ścieżkę geodesyjną przerwaną przez antymeryka do wielu ścieżek podrzędnych.

function getGeodesicPaths(path: LineString | Position[], nodeSize?: number): Position[][]

Parametry

path

LineString | Position[]

Tablica obiektów położenia, które tworzą ścieżkę do wypełnienia.

nodeSize

number

Liczba węzłów do wstawienia między poszczególnymi pozycjami. Ustawienie domyślne: 15

Zwraca

Position[][]

Tablica ścieżek, które tworzą ścieżki geodesowe, Porównanie z getGeodesicPath, ścieżki podrzędne zawsze będą zawierać długość geograficzną w zakresie od -180 do 180

getHeading(Position | Point, Position | Point)

Oblicza nagłówek z jednego obiektu położenia do drugiego.

function getHeading(origin: Position | Point, destination: Position | Point): number

Parametry

origin

Position | Point

Punkt pochodzenia.

destination

Position | Point

Miejsce docelowe do obliczenia względnego nagłówka.

Zwraca

number

Nagłówek w stopniach od 0 do 360. 0 stopni punktów ze względu na północ.

getLengthOfPath(LineString | Position[], string | DistanceUnits)

Oblicza odległość między wszystkimi obiektami położenia w tablicy.

function getLengthOfPath(path: LineString | Position[], units?: string | DistanceUnits): number

Parametry

path

LineString | Position[]

Tablica obiektów położenia, które składają się na ścieżkę do obliczenia długości.

units

string | DistanceUnits

Jednostka miary odległości. Ustawienie domyślne: mierniki

Zwraca

number

Odległość między wszystkimi pozycjami między wszystkimi obiektami położenia w tablicy na powierzchni ziemi w określonych jednostkach.

getPathDenormalizedAtAntimerian(LineString | Position[])

Denormalizuje ścieżkę na antymerykanidzie, to sprawia, że linie ze współrzędnymi po przeciwnej stronie antymeryka, aby zawsze go przekraczać. Należy pamiętać, że ścieżka przechodząca przez antymeryka będzie zawierać długość geograficzną poza zakresem od -180 do 180. Jeśli nie jest to pożądane, zobacz getPathSplitByAntimeridian.

function getPathDenormalizedAtAntimerian(path: LineString | Position[]): Position[]

Parametry

path

LineString | Position[]

Tablica obiektów położenia lub linii w celu zdenormalizowania

Zwraca

Position[]

Zdenormalizowana tablica obiektów położenia, przejście przez ścieżkę antymerykan będzie zawierać długość geograficzną poza zakresem od -180 do 180.

getPathSplitByAntimeridian(LineString | Position[])

Podziel ścieżkę na antymerykanie na wiele ścieżek. Jeśli nie jest to pożądane, zobacz getPathDenormalizedAtAntimerian.

function getPathSplitByAntimeridian(path: LineString | Position[]): Position[][]

Parametry

path

LineString | Position[]

Tablica obiektów położenia lub linii do podziału

Zwraca

Position[][]

Ścieżka podzielona na wiele ścieżek przez antymeryka.

getPixelHeading(Position | Point, Position | Point)

Oblicza dokładny nagłówek pikseli z jednej pozycji do innej w oparciu o projekcję mapy Mercator. Ten nagłówek jest wizualnie dokładny.

function getPixelHeading(origin: Position | Point, destination: Position | Point): number

Parametry

origin

Position | Point

destination

Position | Point

Zwraca

number

getPointsWithHeadingsAlongPath(LineString | Position[], number)

Pobiera tablicę równomiernie rozmieszczonych punktów z nagłówkami wzdłuż ścieżki.

function getPointsWithHeadingsAlongPath(path: LineString | Position[], numPoints: number): Array<Feature<Point, { heading: number }>>

Parametry

path

LineString | Position[]

Ścieżka do pobierania pozycji z.

numPoints

number

Liczba punktów do uzyskania.

Zwraca

Array<Feature<Point, { heading: number }>>

Tablica równomiernie rozmieszczonych punktów z nagłówkami wzdłuż ścieżki.

getPointWithHeadingAlongPath(LineString | Position[], number, string | DistanceUnits)

Pobiera punkt z nagłówkiem określonej odległości wzdłuż ścieżki.

function getPointWithHeadingAlongPath(path: LineString | Position[], distance: number, units?: string | DistanceUnits): Feature<Point, { heading: number }>

Parametry

path

LineString | Position[]

Ścieżka do uzyskania punktu.

distance

number

Odległość wzdłuż ścieżki, aby uzyskać punkt.

units

string | DistanceUnits

Jednostki odległości.

Zwraca

Feature<Point, { heading: number }>

Punkt z nagłówkiem określonej odległości wzdłuż ścieżki.

getPosition(Position | Point | Feature<Point, any> | Shape)

Pobiera położenie obiektu, który jest pozycją, punktem, funkcją punktu lub okręgiem. Jeśli jest to okrąg, zostanie zwrócona jego współrzędna środkowa.

function getPosition(data: Position | Point | Feature<Point, any> | Shape): Position

Parametry

data

Position | Point | Feature<Point, any> | Shape

Obiekt danych do wyodrębnienia pozycji z.

Zwraca

Position

Położenie obiektu, który jest funkcją położenia, punktu lub punktu. Zwraca wartość null, jeśli przekazano nieprawidłowe dane.

getPositionAlongPath(LineString | Position[], number, string | DistanceUnits)

Oblicza obiekt położenia na ścieżce, która jest określoną odległością od początku ścieżki. Jeśli określona odległość jest dłuższa niż długość ścieżki, zostanie zwrócona ostatnia pozycja ścieżki.

function getPositionAlongPath(path: LineString | Position[], distance: number, units?: string | DistanceUnits): Position

Parametry

path

LineString | Position[]

Wieloliniowa lub tablica współrzędnych położenia, które tworzą ścieżkę.

distance

number

Odległość wzdłuż ścieżki (od początku) do obliczenia pozycji dla.

units

string | DistanceUnits

Jednostka miary odległości. Wartość domyślna to mierniki.

Zwraca

Position

Obiekt położenia, który jest określoną odległością od początku ścieżki podczas podążania za ścieżką.

getPositions(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)

Pobiera tablicę wszystkich pozycji w podanej geometrii, funkcji lub tablicy geometrii/cech.

function getPositions(data: Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape): Position[]

Parametry

data

Position[] | Geometry | Feature<Geometry, any> | FeatureCollection | GeometryCollection | Geometry[] | Array<Feature<Geometry, any> | Shape> | Shape

Geometrie lub cechy, z których mają być pobierane pozycje.

Zwraca

Position[]

Tablica wszystkich pozycji w dostarczonej geometrii, funkcji lub tablicy geometrii/cech.

getPositionsAlongPath(LineString | Position[], number)

Pobiera tablicę równomiernie rozmieszczonych pozycji wzdłuż ścieżki.

function getPositionsAlongPath(path: LineString | Position[], numPositions: number): Position[]

Parametry

path

LineString | Position[]

Ścieżka do pobierania pozycji z.

numPositions

number

Liczba pozycji do pobrania.

Zwraca

Position[]

Tablica równomiernie rozmieszczonych pozycji wzdłuż ścieżki.

getRegularPolygonPath(Position | Point, number, number, string | DistanceUnits, number)

Oblicza tablicę obiektów położenia, które są równą odległością od punktu centralnego, aby utworzyć zwykły wielokąt.

function getRegularPolygonPath(origin: Position | Point, radius: number, numberOfPositions: number, units?: string | DistanceUnits, offset?: number): Position[]

Parametry

origin

Position | Point

Środek zwykłego wielokąta.

radius

number

Promień zwykłego wielokąta.

numberOfPositions

number

Liczba pozycji, które powinien mieć wielokąt.

units

string | DistanceUnits

Jednostka miary odległości. Wartość domyślna to mierniki.

offset

number

Przesunięcie do obracania wielokąta. Gdy wartość 0 pierwszej pozycji będzie zgodna z północą.

Zwraca

Position[]

Tablica obiektów położenia, które tworzą zwykły wielokąt.

getRegularPolygonPaths(Position | Point, number, number, string | DistanceUnits, number)

Oblicza tablicę obiektów położenia, które są równą odległością od punktu centralnego, aby utworzyć zwykły wielokąt podzielony przez antymerykad na wiele ścieżek podrzędnych.

function getRegularPolygonPaths(origin: Position | Point, radius: number, numberOfPositions: number, units?: string | DistanceUnits, offset?: number): Position[][]

Parametry

origin

Position | Point

Środek zwykłego wielokąta.

radius

number

Promień zwykłego wielokąta.

numberOfPositions

number

Liczba pozycji, które powinien mieć wielokąt.

units

string | DistanceUnits

Jednostka miary odległości. Wartość domyślna to mierniki.

offset

number

Przesunięcie do obracania wielokąta. Gdy wartość 0 pierwszej pozycji będzie zgodna z północą.

Zwraca

Position[][]

Tablica ścieżek, które tworzą zwykły wielokąt. Porównywanie z parametrem getRegularPolygonPath, ścieżki podrzędne zawsze będą zawierać długość geograficzną w zakresie od -180 do 180

getSpeed(Position | Point | Feature<Point, any>, Position | Point | Feature<Point, any>, number, string | TimeUnits, string | SpeedUnits, number)

Oblicza średnią prędkość podróży między dwoma punktami na podstawie podanego czasu.

function getSpeed(origin: Position | Point | Feature<Point, any>, destination: Position | Point | Feature<Point, any>, timespan: number, timeUnits?: string | TimeUnits, speedUnits?: string | SpeedUnits, decimals?: number): number

Parametry

origin

Position | Point | Feature<Point, any>

Początkowy punkt, z którego jest obliczana szybkość.

destination

Position | Point | Feature<Point, any>

Ostatni punkt, z którego jest obliczana szybkość.

timespan

number

timeUnits

string | TimeUnits

Jednostki wartości czasu. Jeśli nie określono sekund, są używane.

speedUnits

string | SpeedUnits

Jednostki, w których ma być zwracana wartość szybkości. Jeśli nie określono m/s, są używane.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Średnia prędkość podróży między dwoma punktami na podstawie podanego czasu.

getSpeedFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string | SpeedUnits, number)

Oblicza średnią prędkość podróży między dwoma cechami punktów, które mają właściwość zawierającą sygnaturę czasową. Sygnatura czasowa może być następująca:

• Obiekt Date języka JavaScript
• Liczba reprezentująca liczbę milisekund od 1 stycznia 1970 r.
• Ciąg, który używa jednego z następujących formatów:
  • Format daty ISO8601 (tj. 2012-04-23T18:25:43.511Z)
  • Składnia daty RFC282/ IETF (sekcja 3.3)
  • Ciąg daty OData (tj. "/Date(1235764800000)/")

function getSpeedFromFeatures(origin: Feature<Point, any>, destination: Feature<Point, any>, timestampProperty: string, speedUnits?: string | SpeedUnits, decimals?: number): number

Parametry

origin

Feature<Point, any>

Początkowy punkt, z którego jest obliczana szybkość.

destination

Feature<Point, any>

Ostatni punkt, z którego jest obliczana szybkość.

timestampProperty

string

Nazwa właściwości funkcji, która zawiera informacje o znaczniku czasu.

speedUnits

string | SpeedUnits

Jednostki, w których ma być zwracana wartość szybkości. Jeśli nie określono m/s, są używane.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Szybkość w określonych jednostkach lub NaN, jeśli nie znaleziono prawidłowych sygnatur czasowych.

getTimespan(Date | string | number, Date | string | number, TimeUnits, number)

Oblicza przedział czasu między dwiema datami lub znacznikami czasu. Sygnatury czasowe mogą być następujące:

• Obiekt Date języka JavaScript
• Liczba reprezentująca liczbę milisekund od 1 stycznia 1970 r.
• Ciąg, który używa jednego z następujących formatów:
  • Format daty ISO8601 (tj. 2012-04-23T18:25:43.511Z)
  • Składnia daty RFC282/ IETF (sekcja 3.3)
  • Ciąg daty OData (tj. "/Date(1235764800000)/")

function getTimespan(startTime: Date | string | number, endTime: Date | string | number, units?: TimeUnits, decimals?: number): number

Parametry

startTime

Date | string | number

Data lub godzina rozpoczęcia.

endTime

Date | string | number

Data lub godzina zakończenia.

units

TimeUnits

Jednostki, w których ma być zwracana wartość czasu. Jeśli nie określono sekund, są używane.

decimals

number

Zwraca

number

Przedział czasu między dwiema datami lub znacznikami czasu. Zwraca wartość NaN, jeśli nie można przeanalizować sygnatur czasowych.

getTravelDistance(string, number, number, number, string | TimeUnits, string | SpeedUnits, string, number)

Oblicza odległość podróżną dla określonego przedziału czasu, prędkości i opcjonalnie przyspieszenia. Formuła: d = vt + 0,5a*t^2

function getTravelDistance(distanceUnits: string, timespan: number, speed: number, acceleration?: number, timeUnits?: string | TimeUnits, speedUnits?: string | SpeedUnits, accelerationUnits?: string, decimals?: number): number

Parametry

distanceUnits

string

Jednostki odległości, w których ma być zwrócona odległość.

timespan

number

Przedział czasu do obliczenia odległości dla.

speed

number

Początkowa lub stała prędkość.

acceleration

number

Opcjonalny. Przyspieszenie, które zwiększa szybkość w czasie.

timeUnits

string | TimeUnits

Jednostki przedziału czasu. Jeśli nie określono sekund, są używane.

speedUnits

string | SpeedUnits

Jednostki wartości szybkości. Jeśli nie określono m/s, są używane.

accelerationUnits

string

Opcjonalny. Jednostki wartości przyspieszenia. Jeśli nie określono wartości m/s^2, są używane.

decimals

number

Liczba miejsc dziesiętnych, do których należy zaokrąglić wynik.

Zwraca

number

Odległość podróżować dla określonego przedziału czasu, prędkości i opcjonalnie przyspieszenia.

interpolate(Position | Point, Position | Point, number)

Oblicza obiekt położenia, który jest odległością ułamkową między dwoma obiektami położenia.

function interpolate(origin: Position | Point, destination: Position | Point, fraction?: number): Position

Parametry

origin

Position | Point

Pierwsze położenie, aby obliczyć punkt środkowy między.

destination

Position | Point

Drugie położenie do obliczenia punktu środkowego między.

fraction

number

Parametr ułamkowy do obliczania punktu środkowego. Wartość domyślna 0.5.

Zwraca

Position

Położenie, które leży ułamek odległości między dwoma obiektami położenia względem obiektu pierwszej pozycji.

mercatorPixelsToPositions(Pixel[], number)

Konwertuje tablicę globalnych współrzędnych pikseli Mercatora na tablicę pozycji geoprzestrzennych na określonym poziomie powiększenia. Współrzędne globalne pikseli są względem lewego górnego rogu mapy [-180, 90].

function mercatorPixelsToPositions(pixels: Pixel[], zoom: number): Position[]

Parametry

pixels

Pixel[]

Tablica współrzędnych pikseli.

zoom

number

Poziom powiększenia.

Zwraca

Position[]

Tablica pozycji.

mercatorPositionsToPixels(Position[], number)

Konwertuje tablicę pozycji na tablicę globalnych współrzędnych pikseli Mercator na określonym poziomie powiększenia.

function mercatorPositionsToPixels(positions: Position[], zoom: number): Pixel[]

Parametry

positions

Position[]

Tablica pozycji.

zoom

number

Poziom powiększenia.

Zwraca

Pixel[]

Tablica globalnych pikseli mercatora.

normalizeLatitude(number)

Normalizuje wartość szerokości geograficznej z zakresu od -90 do 90 stopni.

function normalizeLatitude(lat: number): number

Parametry

lat

number

Wartość szerokości geograficznej do normalizacji.

Zwraca

number

normalizeLongitude(number)

Normalizuje wartość długości geograficznej z zakresu od -180 do 180 stopni.

function normalizeLongitude(lng: number): number

Parametry

lng

number

Wartość długości geograficznej do normalizacji.

Zwraca

number

parseTimestamp(Date | string | number)

Analizuje znacznik czasu w obiekcie Date języka JavaScript. Sygnatury czasowe mogą być następujące:

• Obiekt Date języka JavaScript
• Liczba reprezentująca liczbę milisekund od 1 stycznia 1970 r.
• Ciąg, który używa jednego z następujących formatów:
  • Format daty ISO8601 (tj. 2012-04-23T18:25:43.511Z)
  • Składnia daty RFC282/ IETF (sekcja 3.3)
  • Ciąg daty OData (tj. "/Date(1235764800000)/")

function parseTimestamp(timestamp: Date | string | number): Date

Parametry

timestamp

Date | string | number

Wartość znacznika czasu do przeanalizowana.

Zwraca

Date

Obiekt Date reprezentujący znacznik czasu lub wartość null, jeśli nie można przeanalizować znacznika czasu.

rotatePositions(Position[], Position | Point, number)

Przyjmuje tablicę pozycji i obraca je wokół danej pozycji dla określonego kąta obrotu.

function rotatePositions(positions: Position[], origin: Position | Point, angle: number): Position[]

Parametry

positions

Position[]

Tablica pozycji do obrócenia.

origin

Position | Point

Pozycja do obracania pozycji wokół.

angle

number

Ilość obracania tablicy pozycji w stopniach zgodnie z ruchem wskazówek zegara.

Zwraca

Position[]

simplify((Position | Pixel)[], number)

Przeprowadź uproszczenie Douglas-Peucker na tablicy pozycji lub pikseli.

function simplify(points: (Position | Pixel)[], tolerance: number): (Position | Pixel)[]

Parametry

points

(Position | Pixel)[]

Położenie lub piksel punkty, które należy uprościć.

tolerance

number

Tolerancja do użycia w uproszczeniu.

Zwraca

(Position | Pixel)[]

Nowa tablica uproszczonego zestawu punktów.