Share via

math module

  • Referência
Pacote:
azure-maps-control

Classes

AffineTransform

Uma classe Affine Transform gerada a partir de um conjunto de pontos de referência.

Enumerações

AccelerationUnits

Unidades de medida para aceleração.
AreaUnits

Unidades de medição para áreas.
DistanceUnits

Unidades de medida para distâncias.
SpeedUnits

Unidades de medida para velocidade.
TimeUnits

Unidades de medida para o tempo.

Funções

boundingBoxToPolygon(BoundingBox)

Pega um BoundingBox e converte-o em um polígono.
convertAcceleration(number, string | AccelerationUnits, string | AccelerationUnits, number)

Converte um valor de aceleração de uma unidade para outra. Unidades com suporte: milesPerSecondSquared, kmsPerSecondSquared, metersPerSecondSquared, feetPerSecondSquared yardsPerSecondSquared, milesPerHoursSecond, milesPerHourSecond, knotsPerSecond, standardGravity
convertArea(number, string, string, number)

Converte um valor de área de uma unidade para outra. Unidades com suporte: squareMeters, acres, hectares, squareFeet, squareYards, squareMiles, squareKilometers
convertDistance(number, string | DistanceUnits, string | DistanceUnits, number)

Converte uma distância de uma unidade de distância para outra. Unidades com suporte: milhas, náuticoMiles, jardas, metros, quilômetros, pés
convertSpeed(number, string | SpeedUnits, string | SpeedUnits, number)

Converte um valor de velocidade de uma unidade para outra. Unidades com suporte: milesPerHour, milesPerHour, metersPerSecond, feetPerSecond, nós, mach
convertTimespan(number, string | TimeUnits, string | TimeUnits, number)

Converte um valor de intervalo de data/hora de uma unidade para outra. Unidades com suporte: ms (milissegundos), horas, minutos, segundos
getAcceleration(number, number, number, string | SpeedUnits, string | DistanceUnits, string | TimeUnits, string | AccelerationUnits, number)

Calcula uma aceleração com base em uma velocidade inicial, distância de viagem e tempo limite. Fórmula: a = 2*(d - v*t)/t^2
getAccelerationFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string, string | SpeedUnits, string | AccelerationUnits, number)

Calcula uma aceleração entre dois recursos de ponto que têm uma propriedade de carimbo de data/hora e, opcionalmente, uma propriedade de velocidade. se as velocidades forem fornecidas, ignore a distância entre os pontos, pois o caminho pode não ter sido reto e calcule: a = (v2 - v1)/(t2 - t1) se velocidades não fornecidas ou fornecidas apenas no primeiro ponto, calcule a distância de linha reta entre os pontos e calcule: a = 2*(d - v*t)/t^2
getAccelerationFromSpeeds(number, number, number, string | SpeedUnits, string | TimeUnits, string | AccelerationUnits, number)

Calcula uma aceleração com base em uma velocidade inicial, velocidade final e tempo limite. Fórmula: a = 2* (v2 - v1)/t
getArea(atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, AreaUnits, number)

Calcula a área aproximada de uma geometria nas unidades especificadas
getCardinalSpline(Position[], number, number, boolean)

Calcula uma matriz de posições que formam um spline cardinal entre a matriz de posições especificada.
getClosestPointOnGeometry(Position | Point | Feature<Point, any> | Shape, atlas.data.Geometry | Feature<atlas.data.Geometry, any> | Shape, string | DistanceUnits, number)

Calcula o ponto mais próximo na borda de uma geometria para um ponto ou posição especificado. O recurso de ponto retornado terá uma distance propriedade que especifica a distância entre os dois pontos nas unidades especificadas. Se a geometria for um ponto, essa posição de pontos será usada para o resultado. Se a geometria for um MultiPoint, as distâncias para as posições individuais serão usadas. Se a geometria for um Polígono ou MultiPolygon, o ponto mais próximo de qualquer borda será retornado, independentemente de o ponto se cruzar ou não a geometria.
getConvexHull(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)

Calcula um Casco Convex de uma matriz de posições, geometrias ou recursos.
getDestination(Position | Point, number, number, string | DistanceUnits)

Calcula uma posição de destino com base em uma posição inicial, um título, uma distância e um tipo de unidade de distância.
getDistanceTo(Position | Point, Position | Point, string | DistanceUnits)

Calcule a distância entre dois objetos de posição na superfície da terra usando a fórmula Haversine.
getEarthRadius(string | DistanceUnits)

Recupera o raio da terra em uma unidade de distância específica para WGS84.
getGeodesicPath(LineString | Position[], number)

Usa uma matriz de objetos de posições e preenche o espaço entre eles com posições posicionadas com precisão para formar um caminho geodésico aproximado.
getGeodesicPaths(LineString | Position[], number)

Usa uma matriz de objetos de posições e preenche o espaço entre eles com posições posicionadas com precisão para formar um caminho geodésico aproximado quebrado pelo antimeridiano em vários sub-caminhos.
getHeading(Position | Point, Position | Point)

Calcula o título de um objeto de posição para outro.
getLengthOfPath(LineString | Position[], string | DistanceUnits)

Calcula a distância entre todos os objetos de posição em uma matriz.
getPathDenormalizedAtAntimerian(LineString | Position[])

Desnormaliza o caminho no antimeridiano, isso faz com que as linhas com coordenadas no lado oposto do antimeridiano sempre o cruzem. Observe que o caminho que cruza o antimeridiano conterá longitude fora do intervalo de -180 a 180. Consulte getPathSplitByAntimeridian quando isso não for desejado.
getPathSplitByAntimeridian(LineString | Position[])

Dividir caminho no antimeridiano em vários caminhos. Consulte getPathDenormalizedAtAntimerian quando isso não for desejado.
getPixelHeading(Position | Point, Position | Point)

Calcula o título preciso do pixel de uma posição para outra com base na projeção de mapa do Mercator. Esse título é visualmente preciso.
getPointsWithHeadingsAlongPath(LineString | Position[], number)

Obtém uma matriz de pontos espaçados uniformemente com títulos ao longo de um caminho.
getPointWithHeadingAlongPath(LineString | Position[], number, string | DistanceUnits)

Obtém um ponto com o título de uma distância especificada ao longo de um caminho.
getPosition(Position | Point | Feature<Point, any> | Shape)

Obtém a posição de um objeto que é uma posição, ponto, recurso de ponto ou círculo. Se for um círculo, sua coordenada central será retornada.
getPositionAlongPath(LineString | Position[], number, string | DistanceUnits)

Calcula o objeto de posição em um caminho que está a uma distância especificada do início do caminho. Se a distância especificada for maior que o comprimento do caminho, a última posição do caminho será retornada.
getPositions(Position[] | atlas.data.Geometry | Feature<atlas.data.Geometry, any> | FeatureCollection | GeometryCollection | atlas.data.Geometry[] | Array<Feature<atlas.data.Geometry, any> | Shape> | Shape)

Recupera uma matriz de todas as posições na geometria, no recurso ou na matriz de geometrias/recursos fornecidos.
getPositionsAlongPath(LineString | Position[], number)

Obtém uma matriz de posições espaçadas uniformemente ao longo de um caminho.
getRegularPolygonPath(Position | Point, number, number, string | DistanceUnits, number)

Calcula uma matriz de objetos de posição que estão a uma distância igual de um ponto central para criar um polígono regular.
getRegularPolygonPaths(Position | Point, number, number, string | DistanceUnits, number)

Calcula uma matriz de objetos de posição que estão a uma distância igual de um ponto central para criar um polígono regular quebrado pelo antimeridiano em vários sub-caminhos.
getSpeed(Position | Point | Feature<Point, any>, Position | Point | Feature<Point, any>, number, string | TimeUnits, string | SpeedUnits, number)

Calcula a velocidade média da viagem entre dois pontos com base na quantidade de tempo fornecida.
getSpeedFromFeatures(Feature<Point, any>, Feature<Point, any>, string, string | SpeedUnits, number)

Calcula a velocidade média de viagem entre dois recursos de ponto que têm uma propriedade que contém um carimbo de data/hora. O carimbo de data/hora pode ser;

  • Um objeto Data do JavaScript
  • Um número que representa o número de milissegundos desde 1º de janeiro de 1970.
  • Uma cadeia de caracteres que usa um dos seguintes formatos:
    • Formato de data ISO8601 (ou seja, 2012-04-23T18:25:43.511Z)
    • Sintaxe de data RFC282 / IETF (seção 3.3)
    • Cadeia de caracteres OData Date (ou seja, "/Date(1235764800000)/")
getTimespan(Date | string | number, Date | string | number, TimeUnits, number)

Calcula o período de tempo entre duas datas ou carimbos de data/hora. Carimbos de data/hora podem ser;

  • Um objeto Data javaScript
  • Um número que representa o número de milissegundos desde 1º de janeiro de 1970.
  • Uma cadeia de caracteres que usa um dos seguintes formatos:
    • Formato de data ISO8601 (ou seja, 2012-04-23T18:25:43.511Z)
    • Sintaxe de data RFC282 / IETF (seção 3.3)
    • Cadeia de caracteres OData Date (ou seja, "/Date(1235764800000)/")
getTravelDistance(string, number, number, number, string | TimeUnits, string | SpeedUnits, string, number)

Calcula a distância percorrida para um período de tempo especificado, velocidade e, opcionalmente, uma aceleração. Fórmula: d = vt + 0,5a*t^2
interpolate(Position | Point, Position | Point, number)

Calcula um objeto de posição que é uma distância fracionária entre dois objetos de posição.
mercatorPixelsToPositions(Pixel[], number)

Converte uma matriz de coordenadas globais de pixel do Mercator em uma matriz de posições geoespaciais em um nível de zoom especificado. As coordenadas de pixel globais são relativas ao canto superior esquerdo do mapa [-180, 90].
mercatorPositionsToPixels(Position[], number)

Converte uma matriz de posições em uma matriz de coordenadas de pixel do Mercator global em um nível de zoom especificado.
normalizeLatitude(number)

Normaliza um valor de latitude entre -90 e 90 graus.
normalizeLongitude(number)

Normaliza um valor de longitude entre -180 e 180 graus.
parseTimestamp(Date | string | number)

Analisa um carimbo de data/hora em um objeto Data javaScript. Carimbos de data/hora podem ser;

  • Um objeto Data javaScript
  • Um número que representa o número de milissegundos desde 1º de janeiro de 1970.
  • Uma cadeia de caracteres que usa um dos seguintes formatos:
    • Formato de data ISO8601 (ou seja, 2012-04-23T18:25:43.511Z)
    • Sintaxe de data RFC282 / IETF (seção 3.3)
    • Cadeia de caracteres OData Date (ou seja, "/Date(1235764800000)/")
rotatePositions(Position[], Position | Point, number)

Usa uma matriz de posições e as gira em torno de uma determinada posição para o ângulo de rotação especificado.
simplify((Position | Pixel)[], number)

Execute uma simplificação Douglas-Peucker em uma matriz de posições ou pixels.

Detalhes da função

boundingBoxToPolygon(BoundingBox)

Pega um BoundingBox e converte-o em um polígono.

function boundingBoxToPolygon(bounds: BoundingBox): Polygon

Parâmetros

bounds
BoundingBox

O BoundingBox a ser convertido em um polígono.

Retornos

Polygon

Uma representação de polígono da BoundingBox.

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

Converte um valor de aceleração de uma unidade para outra. Unidades com suporte: milesPerSecondSquared, kmsPerSecondSquared, metersPerSecondSquared, feetPerSecondSquared yardsPerSecondSquared, milesPerHoursSecond, milesPerHourSecond, knotsPerSecond, standardGravity

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

Parâmetros

acceleration

number

O valor de aceleração a ser convertido.

fromUnits

string | AccelerationUnits

As unidades de aceleração em que o valor está.

toUnits

string | AccelerationUnits

As unidades de aceleração para as quais converter.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

Um valor de aceleração conversor de uma unidade para outra.

convertArea(number, string, string, number)

Converte um valor de área de uma unidade para outra. Unidades com suporte: squareMeters, acres, hectares, squareFeet, squareYards, squareMiles, squareKilometers

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

Parâmetros

area

number

O valor da área a ser convertido.

fromUnits

string

As unidades de área em que o valor está.

toUnits

string

As unidades de área para a qual converter.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

Um valor de área conversor de uma unidade para outra.

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

Converte uma distância de uma unidade de distância para outra. Unidades com suporte: milhas, náuticoMiles, jardas, metros, quilômetros, pés

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

Parâmetros

distance

number

Um número que representa uma distância a ser convertida.

fromUnits

string | DistanceUnits

As unidades de distância em que a distância original está.

toUnits

string | DistanceUnits

As unidades de distância desejadas para converter.

decimals

number

Especifica o número de casas decimais para arredondar o resultado. Se indefinido, nenhum arredondamento ocorrerá.

Retornos

number

Uma distância nas novas unidades.

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

Converte um valor de velocidade de uma unidade para outra. Unidades com suporte: milesPerHour, milesPerHour, metersPerSecond, feetPerSecond, nós, mach

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

Parâmetros

speed

number

O valor de velocidade a ser convertido.

fromUnits

string | SpeedUnits

As unidades de velocidade das quais converter.

toUnits

string | SpeedUnits

As unidades de velocidade para as quais converter.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

Um valor de velocidade conversor de uma unidade para outra.

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

Converte um valor de intervalo de data/hora de uma unidade para outra. Unidades com suporte: ms (milissegundos), horas, minutos, segundos

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

Parâmetros

timespan

number

O valor de tempo a ser convertido.

fromUnits

string | TimeUnits

As unidades de tempo a serem convertidas.

toUnits

string | TimeUnits

As unidades de tempo a serem convertidas.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

Um valor de tempo conversor de uma unidade para outra.

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

Calcula uma aceleração com base em uma velocidade inicial, distância de viagem e tempo limite. Fórmula: 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

Parâmetros

initialSpeed

number

A velocidade inicial.

distance

number

A distância que foi percorrida.

timespan

number

O tempo que foi viajado.

speedUnits

string | SpeedUnits

As unidades das informações de velocidade. Se não for especificado m/s são usados.

distanceUnits

string | DistanceUnits

As unidades das informações de distância. Se os medidores não especificados não forem usados.

timeUnits

string | TimeUnits

As unidades das informações do intervalo de tempo. Se os segundos não especificados não forem usados.

accelerationUnits

string | AccelerationUnits

As unidades em que retornar o valor de aceleração. Se não for especificado m/s^2 serão usados.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

Uma aceleração baseada em uma velocidade inicial, distância de viagem e tempo limite.

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

Calcula uma aceleração entre dois recursos de ponto que têm uma propriedade de carimbo de data/hora e, opcionalmente, uma propriedade de velocidade. se as velocidades forem fornecidas, ignore a distância entre os pontos, pois o caminho pode não ter sido reto e calcule: a = (v2 - v1)/(t2 - t1) se velocidades não fornecidas ou fornecidas apenas no primeiro ponto, calcule a distância de linha reta entre os pontos e calcule: 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

Parâmetros

origin

Feature<Point, any>

O ponto inicial do qual a aceleração é calculada.

destination

Feature<Point, any>

O ponto final do qual a aceleração é calculada.

timestampProperty

string

O nome da propriedade nos recursos que contém as informações do carimbo de data/hora.

speedProperty

string

O nome da propriedade nos recursos que contém uma informação de velocidade.

speedUnits

string | SpeedUnits

As unidades das informações de velocidade. Se não for especificado m/s é usado.

accelerationUnits

string | AccelerationUnits

As unidades em que retornar o valor de aceleração. Se não for especificado m/s^2 serão usados.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

Uma aceleração entre recursos de dois pontos que têm uma propriedade de carimbo de data/hora e, opcionalmente, uma propriedade de velocidade. Retorna NaN se não for possível analisar o carimbo de data/hora.

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

Calcula uma aceleração com base em uma velocidade inicial, velocidade final e tempo limite. Fórmula: a = 2* (v2 - v1)/t

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

Parâmetros

initialSpeed

number

A velocidade inicial.

finalSpeed

number

A velocidade final.

timespan

number

O tempo que foi viajado.

speedUnits

string | SpeedUnits

As unidades das informações de velocidade. Se os medidores não especificados não forem usados.

timeUnits

string | TimeUnits

As unidades das informações do intervalo de tempo. Se os segundos não especificados não forem usados.

accelerationUnits

string | AccelerationUnits

As unidades em que retornar o valor de aceleração. Se não for especificado m/s^2 serão usados.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

Uma aceleração baseada em uma velocidade inicial, velocidade final e tempo limite.

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

Calcula a área aproximada de uma geometria nas unidades especificadas

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

Parâmetros

data

Geometry | Feature<Geometry, any> | Shape

areaUnits
AreaUnits

Unidade de medição de área. O padrão é squareMeters.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

A área de uma geometria nas unidades especificadas.

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

Calcula uma matriz de posições que formam um spline cardinal entre a matriz de posições especificada.

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

Parâmetros

positions

Position[]

A matriz de posições para calcular o spline.

tension

number

Um número que indica o aperto da curva. Pode ser qualquer número, embora um valor entre 0 e 1 seja geralmente usado. Padrão: 0.5

nodeSize

number

Número de nós a serem inseridos entre cada posição. Padrão: 15

close

boolean

Um booliano que indica se o spline deve ser um anel fechado ou não. Padrão: false

Retornos

Position[]

Uma matriz de posições que formam um spline cardinal entre a matriz de posições especificada.

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

Calcula o ponto mais próximo na borda de uma geometria para um ponto ou posição especificado. O recurso de ponto retornado terá uma distance propriedade que especifica a distância entre os dois pontos nas unidades especificadas. Se a geometria for um ponto, essa posição de pontos será usada para o resultado. Se a geometria for um MultiPoint, as distâncias para as posições individuais serão usadas. Se a geometria for um Polígono ou MultiPolygon, o ponto mais próximo de qualquer borda será retornado, independentemente de o ponto se cruzar ou não a geometria.

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 }>

Parâmetros

pt

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

O ponto ou posição para encontrar o ponto mais próximo na borda da geometria.

geom

Geometry | Feature<Geometry, any> | Shape

A geometria em que encontrar o ponto mais próximo.

units

string | DistanceUnits

Unidade de medida de distância. O padrão é metros.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

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)

Calcula um Casco Convex de uma matriz de posições, geometrias ou recursos.

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

Parâmetros

data

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

A matriz de posições, geometrias ou recursos para calcular um casco convexo.

Retornos

Polygon

Um Casco Convex de uma matriz de posições, geometrias ou recursos.

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

Calcula uma posição de destino com base em uma posição inicial, um título, uma distância e um tipo de unidade de distância.

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

Parâmetros

origin

Position | Point

Posição à qual o destino é relativo.

heading

number

Um ângulo de título entre 0 e 360 graus. 0 - Norte, 90 - Leste, 180 - Sul, 270 - Oeste.

distance

number

Distância que o destino está longe.

units

string | DistanceUnits

Unidade de medida de distância. O padrão é metros.

Retornos

Position

Uma posição que é a distância especificada longe da origem.

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

Calcule a distância entre dois objetos de posição na superfície da terra usando a fórmula Haversine.

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

Parâmetros

origin

Position | Point

Primeira posição para calcular a distância entre.

destination

Position | Point

Segunda posição para calcular a distância entre elas.

units

string | DistanceUnits

Unidade de medida de distância. O padrão é metros.

Retornos

number

A distância mais curta entre duas posições nas unidades especificadas.

getEarthRadius(string | DistanceUnits)

Recupera o raio da terra em uma unidade de distância específica para WGS84.

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

Parâmetros

units

string | DistanceUnits

Unidade de medida de distância. Padrão: medidores

Retornos

number

Um número que representa o raio da terra em uma unidade de distância específica.

getGeodesicPath(LineString | Position[], number)

Usa uma matriz de objetos de posições e preenche o espaço entre eles com posições posicionadas com precisão para formar um caminho geodésico aproximado.

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

Parâmetros

path

LineString | Position[]

Matriz de objetos de posição que formam um caminho a ser preenchido.

nodeSize

number

Número de nós a serem inseridos entre cada posição. Padrão: 15

Retornos

Position[]

Uma matriz de objetos de posição que formam caminhos geodésicos, caminho geodésico cruzando antimeridiano conterá longitude fora do intervalo de -180 a 180. Consulte getGeodesicPaths() quando isso não for desejado.

getGeodesicPaths(LineString | Position[], number)

Usa uma matriz de objetos de posições e preenche o espaço entre eles com posições posicionadas com precisão para formar um caminho geodésico aproximado quebrado pelo antimeridiano em vários sub-caminhos.

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

Parâmetros

path

LineString | Position[]

Matriz de objetos de posição que formam um caminho a ser preenchido.

nodeSize

number

Número de nós a serem inseridos entre cada posição. Padrão: 15

Retornos

Position[][]

Uma matriz de caminhos que formam caminhos geodésicos, comparando com getGeodesicPath, os sub-caminhos sempre conterão longitude no intervalo -180 a 180

getHeading(Position | Point, Position | Point)

Calcula o título de um objeto de posição para outro.

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

Parâmetros

origin

Position | Point

Ponto de origem.

destination

Position | Point

Destino para o qual calcular o título relativo.

Retornos

number

Um título em graus entre 0 e 360. 0 graus de pontos devido ao Norte.

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

Calcula a distância entre todos os objetos de posição em uma matriz.

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

Parâmetros

path

LineString | Position[]

A matriz de objetos de posição que compõem o caminho do qual calcular o comprimento.

units

string | DistanceUnits

Unidade de medida de distância. Padrão: medidores

Retornos

number

A distância entre todas as posições entre todos os objetos de posição em uma matriz na superfície de uma terra nas unidades especificadas.

getPathDenormalizedAtAntimerian(LineString | Position[])

Desnormaliza o caminho no antimeridiano, isso faz com que as linhas com coordenadas no lado oposto do antimeridiano sempre o cruzem. Observe que o caminho que cruza o antimeridiano conterá longitude fora do intervalo de -180 a 180. Consulte getPathSplitByAntimeridian quando isso não for desejado.

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

Parâmetros

path

LineString | Position[]

Matriz de objetos de posição ou linhas para desnormalizar

Retornos

Position[]

Uma matriz desnormalizada de objetos de posição, o caminho que cruza o antimeridiano conterá longitude fora do intervalo de -180 a 180.

getPathSplitByAntimeridian(LineString | Position[])

Dividir caminho no antimeridiano em vários caminhos. Consulte getPathDenormalizedAtAntimerian quando isso não for desejado.

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

Parâmetros

path

LineString | Position[]

Matriz de objetos de posição ou linhas a serem divididas

Retornos

Position[][]

Um caminho dividido em vários caminhos por antimeridiano.

getPixelHeading(Position | Point, Position | Point)

Calcula o título preciso do pixel de uma posição para outra com base na projeção de mapa do Mercator. Esse título é visualmente preciso.

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

Parâmetros

origin

Position | Point

destination

Position | Point

Retornos

number

getPointsWithHeadingsAlongPath(LineString | Position[], number)

Obtém uma matriz de pontos espaçados uniformemente com títulos ao longo de um caminho.

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

Parâmetros

path

LineString | Position[]

O caminho do qual obter as posições.

numPoints

number

O número de pontos a serem obtidos.

Retornos

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

Uma matriz de pontos espaçados uniformemente com títulos ao longo de um caminho.

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

Obtém um ponto com o título de uma distância especificada ao longo de um caminho.

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

Parâmetros

path

LineString | Position[]

O caminho do qual obter o ponto.

distance

number

A distância ao longo do caminho para obter o ponto em.

units

string | DistanceUnits

As unidades de distância.

Retornos

Feature<Point, { heading: number }>

Um ponto com o título de uma distância especificada ao longo de um caminho.

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

Obtém a posição de um objeto que é uma posição, ponto, recurso de ponto ou círculo. Se for um círculo, sua coordenada central será retornada.

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

Parâmetros

data

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

O objeto de dados do qual extrair a posição.

Retornos

Position

A posição de um objeto que é um recurso de posição, ponto ou ponto. Retornará nulo se dados inválidos forem passados.

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

Calcula o objeto de posição em um caminho que está a uma distância especificada do início do caminho. Se a distância especificada for maior que o comprimento do caminho, a última posição do caminho será retornada.

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

Parâmetros

path

LineString | Position[]

Uma polilinha ou matriz de coordenadas de posição que formam um caminho.

distance

number

A distância ao longo do caminho (desde o início) para calcular a posição.

units

string | DistanceUnits

Unidade de medida de distância. O padrão é metros.

Retornos

Position

Um objeto de posição que é a distância especificada longe do início do caminho ao seguir o caminho.

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

Recupera uma matriz de todas as posições na geometria, no recurso ou na matriz de geometrias/recursos fornecidos.

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[]

Parâmetros

data

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

As geometrias ou recursos dos quais recuperar as posições.

Retornos

Position[]

Uma matriz de todas as posições na geometria, no recurso ou na matriz de geometrias/recursos fornecidos.

getPositionsAlongPath(LineString | Position[], number)

Obtém uma matriz de posições espaçadas uniformemente ao longo de um caminho.

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

Parâmetros

path

LineString | Position[]

O caminho do qual obter as posições.

numPositions

number

O número de posições a serem obtidos.

Retornos

Position[]

Uma matriz de posições espaçadas uniformemente ao longo de um caminho.

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

Calcula uma matriz de objetos de posição que estão a uma distância igual de um ponto central para criar um polígono regular.

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

Parâmetros

origin

Position | Point

Centro do polígono normal.

radius

number

Raio do polígono normal.

numberOfPositions

number

Número de posições que o polígono deve ter.

units

string | DistanceUnits

Unidade de medida de distância. O padrão é metros.

offset

number

Um deslocamento para girar o polígono. Quando 0 a primeira posição se alinhará ao Norte.

Retornos

Position[]

Uma matriz de objetos de posição que formam um polígono regular.

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

Calcula uma matriz de objetos de posição que estão a uma distância igual de um ponto central para criar um polígono regular quebrado pelo antimeridiano em vários sub-caminhos.

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

Parâmetros

origin

Position | Point

Centro do polígono normal.

radius

number

Raio do polígono normal.

numberOfPositions

number

Número de posições que o polígono deve ter.

units

string | DistanceUnits

Unidade de medida de distância. O padrão é metros.

offset

number

Um deslocamento para girar o polígono. Quando 0 a primeira posição se alinhará ao Norte.

Retornos

Position[][]

Uma matriz de caminhos que formam um polígono regular. Comparando com getRegularPolygonPath, os sub-caminhos sempre conterão longitude no intervalo -180 a 180

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

Calcula a velocidade média da viagem entre dois pontos com base na quantidade de tempo fornecida.

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

Parâmetros

origin

Position | Point | Feature<Point, any>

O ponto inicial do qual a velocidade é calculada.

destination

Position | Point | Feature<Point, any>

O ponto final do qual a velocidade é calculada.

timespan

number

timeUnits

string | TimeUnits

As unidades do valor de tempo. Se os segundos não especificados não forem usados.

speedUnits

string | SpeedUnits

As unidades em que retornar o valor de velocidade. Se não for especificado m/s são usados.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

A velocidade média da viagem entre dois pontos com base na quantidade de tempo fornecida.

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

Calcula a velocidade média de viagem entre dois recursos de ponto que têm uma propriedade que contém um carimbo de data/hora. O carimbo de data/hora pode ser;

  • Um objeto Data do JavaScript
  • Um número que representa o número de milissegundos desde 1º de janeiro de 1970.
  • Uma cadeia de caracteres que usa um dos seguintes formatos:
    • Formato de data ISO8601 (ou seja, 2012-04-23T18:25:43.511Z)
    • Sintaxe de data RFC282 / IETF (seção 3.3)
    • Cadeia de caracteres OData Date (ou seja, "/Date(1235764800000)/")
function getSpeedFromFeatures(origin: Feature<Point, any>, destination: Feature<Point, any>, timestampProperty: string, speedUnits?: string | SpeedUnits, decimals?: number): number

Parâmetros

origin

Feature<Point, any>

O ponto inicial do qual a velocidade é calculada.

destination

Feature<Point, any>

O ponto final do qual a velocidade é calculada.

timestampProperty

string

O nome da propriedade nos recursos que tem as informações do carimbo de data/hora.

speedUnits

string | SpeedUnits

As unidades em que retornar o valor de velocidade. Se não for especificado m/s são usados.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

A velocidade nas unidades especificadas ou naN se os carimbos de data/hora válidos não forem encontrados.

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

Calcula o período de tempo entre duas datas ou carimbos de data/hora. Carimbos de data/hora podem ser;

  • Um objeto Data javaScript
  • Um número que representa o número de milissegundos desde 1º de janeiro de 1970.
  • Uma cadeia de caracteres que usa um dos seguintes formatos:
    • Formato de data ISO8601 (ou seja, 2012-04-23T18:25:43.511Z)
    • Sintaxe de data RFC282 / IETF (seção 3.3)
    • Cadeia de caracteres OData Date (ou seja, "/Date(1235764800000)/")
function getTimespan(startTime: Date | string | number, endTime: Date | string | number, units?: TimeUnits, decimals?: number): number

Parâmetros

startTime

Date | string | number

A data de início ou hora.

endTime

Date | string | number

A data de término ou hora.

units
TimeUnits

As unidades em que retornar o valor de tempo. Se os segundos não especificados não forem usados.

decimals

number

Retornos

number

Um período de tempo entre duas datas ou carimbos de data/hora. Retorna NaN se não for possível analisar carimbos de data/hora.

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

Calcula a distância percorrida para um período de tempo especificado, velocidade e, opcionalmente, uma aceleração. Fórmula: 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

Parâmetros

distanceUnits

string

As unidades de distância nas quais retornar a distância.

timespan

number

O período de tempo para o qual calcular a distância.

speed

number

A velocidade inicial ou constante.

acceleration

number

Opcional. Uma aceleração que aumenta a velocidade ao longo do tempo.

timeUnits

string | TimeUnits

As unidades do período de tempo. Se os segundos não especificados não forem usados.

speedUnits

string | SpeedUnits

As unidades do valor de velocidade. Se não for especificado m/s são usados.

accelerationUnits

string

Opcional. As unidades do valor de aceleração. Se não for especificado m/s^2 serão usados.

decimals

number

O número de casas decimais para arredondar o resultado.

Retornos

number

A distância percorrida para um período de tempo especificado, velocidade e, opcionalmente, uma aceleração.

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

Calcula um objeto de posição que é uma distância fracionária entre dois objetos de posição.

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

Parâmetros

origin

Position | Point

Primeira posição para calcular o ponto médio entre.

destination

Position | Point

Segunda posição para calcular o ponto médio entre.

fraction

number

O parâmetro fracionário para o qual calcular um ponto médio. Padrão 0.5.

Retornos

Position

Uma posição que reside uma fração da distância entre dois objetos de posição, em relação ao objeto de primeira posição.

mercatorPixelsToPositions(Pixel[], number)

Converte uma matriz de coordenadas globais de pixel do Mercator em uma matriz de posições geoespaciais em um nível de zoom especificado. As coordenadas de pixel globais são relativas ao canto superior esquerdo do mapa [-180, 90].

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

Parâmetros

pixels

Pixel[]

Matriz de coordenadas de pixel.

zoom

number

Nível de zoom.

Retornos

Position[]

Uma matriz de posições.

mercatorPositionsToPixels(Position[], number)

Converte uma matriz de posições em uma matriz de coordenadas de pixel do Mercator global em um nível de zoom especificado.

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

Parâmetros

positions

Position[]

Matriz de posições.

zoom

number

Nível de zoom.

Retornos

Pixel[]

Matriz de pixels do Mercator global.

normalizeLatitude(number)

Normaliza um valor de latitude entre -90 e 90 graus.

function normalizeLatitude(lat: number): number

Parâmetros

lat

number

O valor de latitude a ser normalizado.

Retornos

number

normalizeLongitude(number)

Normaliza um valor de longitude entre -180 e 180 graus.

function normalizeLongitude(lng: number): number

Parâmetros

lng

number

O valor de longitude a ser normalizado.

Retornos

number

parseTimestamp(Date | string | number)

Analisa um carimbo de data/hora em um objeto Data javaScript. Carimbos de data/hora podem ser;

  • Um objeto Data javaScript
  • Um número que representa o número de milissegundos desde 1º de janeiro de 1970.
  • Uma cadeia de caracteres que usa um dos seguintes formatos:
    • Formato de data ISO8601 (ou seja, 2012-04-23T18:25:43.511Z)
    • Sintaxe de data RFC282 / IETF (seção 3.3)
    • Cadeia de caracteres OData Date (ou seja, "/Date(1235764800000)/")
function parseTimestamp(timestamp: Date | string | number): Date

Parâmetros

timestamp

Date | string | number

O valor do carimbo de data/hora a ser analisado.

Retornos

Date

Um objeto Date que representa o carimbo de data/hora ou nulo se o carimbo de data/hora não pôde ser analisado.

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

Usa uma matriz de posições e as gira em torno de uma determinada posição para o ângulo de rotação especificado.

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

Parâmetros

positions

Position[]

Uma matriz de posições a ser girada.

origin

Position | Point

A posição para girar as posições ao redor.

angle

number

A quantidade para girar a matriz de posições em graus no sentido horário.

Retornos

Position[]

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

Execute uma simplificação Douglas-Peucker em uma matriz de posições ou pixels.

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

Parâmetros

points

(Position | Pixel)[]

A posição ou o pixel aponta para simplificar.

tolerance

number

Uma tolerância a ser usada na simplificação.

Retornos

(Position | Pixel)[]

Uma nova matriz do conjunto simplificado de pontos.