AzimuthJS

Azimuthjs

Azimuthjs est un petit script / module autonome pour calculer la distance, l'azimut et la direction entre deux points (étant donné la latitude / longitude de ces points).

Les latitudes sud sont négatives, les longitudes orientales sont positives.

Installation

Lier azimuth.min.js dans votre HTML:

Chargez la version exacte: la dernière version est

 < script src =" https://cdn.jsdelivr.net/gh/theGreski/[email protected]/dist/azimuth.min.js " > </ script >

Chargez une plage de version au lieu d'une version exacte:

 < script src =" https://cdn.jsdelivr.net/gh/theGreski/[email protected]/dist/azimuth.min.js " > </ script >

Omettez complètement la version et utilisez "les derniers" pour charger le dernier (non recommandé pour l'utilisation de la production):

 < script src =" https://cdn.jsdelivr.net/gh/theGreski/AzimuthJS@latest/dist/azimuth.min.js " > </ script >

Module de chargement dans JS:

 const azimuth = require ( 'https://cdn.jsdelivr.net/gh/theGreski/AzimuthJS@latest/dist/azimuth.min.js' ) ; 

Usage

La fonction d'azimut accepte les coordonnées de deux points ({lat: latitude, lng: longitude}, {lat: latitude, lng: longitude}). Par exemple Londres à New York:

 azimuth ( { lat : 51.509865 , lng : - 0.118092 } , { lat : 40.730610 , lng : - 73.935242 } )

La sortie ressemblera à ceci:

 {
    distance : 55648932 ,
    units : "m" ,
    azimuth : 258 ,
    method : "great-circle" ,
    direction : "W"
}

Ou enveloppez le bloc de capture de capture pour trouver toute validation ISUes:

 try {
  azimuth ( 9999 , - 200 , "abc" , null )
} catch ( e ) {
  console . error ( e )
} 

Options

Vous pouvez configurer les options suivantes:

• units
• formula
• distancePrecision
• azimuthPrecision
• directionPrecision

Voici un exemple de spécification de toutes les options disponibles:

 azimuth ( { lat : 51.509865 , lng : - 0.118092 } , { lat : 40.730610 , lng : - 73.935242 } ,  
  {  
    units : "mi" ,  
    formula : "great-circle" ,  
    distancePrecision : 3 ,  
    azimuthPrecision : 3 ,  
    directionPrecision : 2  
  }  
)

La sortie ressemblera à ceci:

 {
    formula : "great-circle" ,
    distance : 5564892.653 ,
    units : "mi" ,
    azimuth : 258.049 ,
    direction : "W"
}

units

Une chaîne indiquant des unités de la distance.

Accepte uniquement:

m pour les mètres,
km pour les kilomètres,
ft pour les pieds,
yd pour yards,
mi sur des kilomètres,
nm pour les kilomètres nautiques

• Par défaut : m

formula

Une chaîne indiquant la formule de calcul.

Accepte uniquement: great-circle pour grand cercle, rhumb-line pour ligne droite

• Par défaut : great-circle

distancePrecision

Un nombre indiquant le nombre de décimales d'arrondissement (précision) pour la mesure de la distance.

• Par défaut : 0

azimuthPrecision

Un nombre indiquant le nombre de décimales d'arrondissement (précision) pour la mesure du roulement.

• Par défaut : 0

directionPrecision

Un nombre indiquant la précision de la mesure de la direction de la boussole.

Accepte uniquement:

0 pas de direction de la boussole,
1 directions cardinales (n, e, s, w)
2 Directions intercardinales (N, NE, E, SE, S, SW, W, NW)
3 Directions intercardinales secondaires (N, NNE, NE, ENE, E, ESE, SE, SSE, S, SSW, SW, WSW, W, WNW, NW, NNW)

• Par défaut : 2

Libéré sous la licence MIT