@antv/l7-map 2.25.5 → 2.25.7

package/lib/map/geo/lng_lat.js

@@ -1,166 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.earthRadius = exports.LngLat = void 0;
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-var _util = require("../util/util");
-/*
- * Approximate radius of the earth in meters.
- * Uses the WGS-84 approximation. The radius at the equator is ~6378137 and at the poles is ~6356752. https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84
- * 6371008.8 is one published "average radius" see https://en.wikipedia.org/wiki/Earth_radius#Mean_radius, or ftp://athena.fsv.cvut.cz/ZFG/grs80-Moritz.pdf p.4
- */
-const earthRadius = exports.earthRadius = 6371008.8;
-
-/**
- * A {@link LngLat} object, an array of two numbers representing longitude and latitude,
- * or an object with `lng` and `lat` or `lon` and `lat` properties.
- *
- * @group Geography and Geometry
- *
- * @example
- * ```ts
- * let v1 = new LngLat(-122.420679, 37.772537);
- * let v2 = [-122.420679, 37.772537];
- * let v3 = {lon: -122.420679, lat: 37.772537};
- * ```
- */
-
-/**
- * A `LngLat` object represents a given longitude and latitude coordinate, measured in degrees.
- * These coordinates are based on the [WGS84 (EPSG:4326) standard](https://en.wikipedia.org/wiki/World_Geodetic_System#WGS84).
- *
- * MapLibre GL JS uses longitude, latitude coordinate order (as opposed to latitude, longitude) to match the
- * [GeoJSON specification](https://tools.ietf.org/html/rfc7946).
- *
- * Note that any MapLibre GL JS method that accepts a `LngLat` object as an argument or option
- * can also accept an `Array` of two numbers and will perform an implicit conversion.
- * This flexible type is documented as {@link LngLatLike}.
- *
- * @group Geography and Geometry
- *
- * @example
- * ```ts
- * let ll = new LngLat(-123.9749, 40.7736);
- * ll.lng; // = -123.9749
- * ```
- * @see [Get coordinates of the mouse pointer](https://maplibre.org/maplibre-gl-js/docs/examples/mouse-position/)
- * @see [Display a popup](https://maplibre.org/maplibre-gl-js/docs/examples/popup/)
- * @see [Create a timeline animation](https://maplibre.org/maplibre-gl-js/docs/examples/timeline-animation/)
- */
-class LngLat {
-  /**
-   * @param lng - Longitude, measured in degrees.
-   * @param lat - Latitude, measured in degrees.
-   */
-  constructor(lng, lat) {
-    (0, _defineProperty2.default)(this, "lng", void 0);
-    (0, _defineProperty2.default)(this, "lat", void 0);
-    if (isNaN(lng) || isNaN(lat)) {
-      throw new Error(`Invalid LngLat object: (${lng}, ${lat})`);
-    }
-    this.lng = +lng;
-    this.lat = +lat;
-    if (this.lat > 90 || this.lat < -90) {
-      throw new Error('Invalid LngLat latitude value: must be between -90 and 90');
-    }
-  }
-
-  /**
-   * Returns a new `LngLat` object whose longitude is wrapped to the range (-180, 180).
-   *
-   * @returns The wrapped `LngLat` object.
-   * @example
-   * ```ts
-   * let ll = new LngLat(286.0251, 40.7736);
-   * let wrapped = ll.wrap();
-   * wrapped.lng; // = -73.9749
-   * ```
-   */
-  wrap() {
-    return new LngLat((0, _util.wrap)(this.lng, -180, 180), this.lat);
-  }
-
-  /**
-   * Returns the coordinates represented as an array of two numbers.
-   *
-   * @returns The coordinates represented as an array of longitude and latitude.
-   * @example
-   * ```ts
-   * let ll = new LngLat(-73.9749, 40.7736);
-   * ll.toArray(); // = [-73.9749, 40.7736]
-   * ```
-   */
-  toArray() {
-    return [this.lng, this.lat];
-  }
-
-  /**
-   * Returns the coordinates represent as a string.
-   *
-   * @returns The coordinates represented as a string of the format `'LngLat(lng, lat)'`.
-   * @example
-   * ```ts
-   * let ll = new LngLat(-73.9749, 40.7736);
-   * ll.toString(); // = "LngLat(-73.9749, 40.7736)"
-   * ```
-   */
-  toString() {
-    return `LngLat(${this.lng}, ${this.lat})`;
-  }
-
-  /**
-   * Returns the approximate distance between a pair of coordinates in meters
-   * Uses the Haversine Formula (from R.W. Sinnott, "Virtues of the Haversine", Sky and Telescope, vol. 68, no. 2, 1984, p. 159)
-   *
-   * @param lngLat - coordinates to compute the distance to
-   * @returns Distance in meters between the two coordinates.
-   * @example
-   * ```ts
-   * let new_york = new LngLat(-74.0060, 40.7128);
-   * let los_angeles = new LngLat(-118.2437, 34.0522);
-   * new_york.distanceTo(los_angeles); // = 3935751.690893987, "true distance" using a non-spherical approximation is ~3966km
-   * ```
-   */
-  distanceTo(lngLat) {
-    const rad = Math.PI / 180;
-    const lat1 = this.lat * rad;
-    const lat2 = lngLat.lat * rad;
-    const a = Math.sin(lat1) * Math.sin(lat2) + Math.cos(lat1) * Math.cos(lat2) * Math.cos((lngLat.lng - this.lng) * rad);
-    const maxMeters = earthRadius * Math.acos(Math.min(a, 1));
-    return maxMeters;
-  }
-
-  /**
-   * Converts an array of two numbers or an object with `lng` and `lat` or `lon` and `lat` properties
-   * to a `LngLat` object.
-   *
-   * If a `LngLat` object is passed in, the function returns it unchanged.
-   *
-   * @param input - An array of two numbers or object to convert, or a `LngLat` object to return.
-   * @returns A new `LngLat` object, if a conversion occurred, or the original `LngLat` object.
-   * @example
-   * ```ts
-   * let arr = [-73.9749, 40.7736];
-   * let ll = LngLat.convert(arr);
-   * ll;   // = LngLat {lng: -73.9749, lat: 40.7736}
-   * ```
-   */
-  static convert(input) {
-    if (input instanceof LngLat) {
-      return input;
-    }
-    if (Array.isArray(input) && (input.length === 2 || input.length === 3)) {
-      return new LngLat(Number(input[0]), Number(input[1]));
-    }
-    if (!Array.isArray(input) && typeof input === 'object' && input !== null) {
-      return new LngLat(
-      // flow can't refine this to have one of lng or lat, so we have to cast to any
-      Number('lng' in input ? input.lng : input.lon), Number(input.lat));
-    }
-    throw new Error('`LngLatLike` argument must be specified as a LngLat instance, an object {lng: <lng>, lat: <lat>}, an object {lon: <lng>, lat: <lat>}, or an array of [<lng>, <lat>]');
-  }
-}
-exports.LngLat = LngLat;

package/lib/map/geo/lng_lat_bounds.d.ts

@@ -1,217 +0,0 @@
-import type { LngLatLike } from './lng_lat';
-import { LngLat } from './lng_lat';
-/**
- * A {@link LngLatBounds} object, an array of {@link LngLatLike} objects in [sw, ne] order,
- * or an array of numbers in [west, south, east, north] order.
- *
- * @group Geography and Geometry
- *
- * @example
- * ```ts
- * let v1 = new LngLatBounds(
- *   new LngLat(-73.9876, 40.7661),
- *   new LngLat(-73.9397, 40.8002)
- * );
- * let v2 = new LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002])
- * let v3 = [[-73.9876, 40.7661], [-73.9397, 40.8002]];
- * ```
- */
-export type LngLatBoundsLike = LngLatBounds | [LngLatLike, LngLatLike] | [number, number, number, number];
-/**
- * A `LngLatBounds` object represents a geographical bounding box,
- * defined by its southwest and northeast points in longitude and latitude.
- *
- * If no arguments are provided to the constructor, a `null` bounding box is created.
- *
- * Note that any Mapbox GL method that accepts a `LngLatBounds` object as an argument or option
- * can also accept an `Array` of two {@link LngLatLike} constructs and will perform an implicit conversion.
- * This flexible type is documented as {@link LngLatBoundsLike}.
- *
- * @group Geography and Geometry
- *
- * @example
- * ```ts
- * let sw = new LngLat(-73.9876, 40.7661);
- * let ne = new LngLat(-73.9397, 40.8002);
- * let llb = new LngLatBounds(sw, ne);
- * ```
- */
-export declare class LngLatBounds {
-    _ne: LngLat;
-    _sw: LngLat;
-    /**
-     * @param sw - The southwest corner of the bounding box.
-     * OR array of 4 numbers in the order of  west, south, east, north
-     * OR array of 2 LngLatLike: [sw,ne]
-     * @param ne - The northeast corner of the bounding box.
-     * @example
-     * ```ts
-     * let sw = new LngLat(-73.9876, 40.7661);
-     * let ne = new LngLat(-73.9397, 40.8002);
-     * let llb = new LngLatBounds(sw, ne);
-     * ```
-     * OR
-     * ```ts
-     * let llb = new LngLatBounds([-73.9876, 40.7661, -73.9397, 40.8002]);
-     * ```
-     * OR
-     * ```ts
-     * let llb = new LngLatBounds([sw, ne]);
-     * ```
-     */
-    constructor(sw?: LngLatLike | [number, number, number, number] | [LngLatLike, LngLatLike], ne?: LngLatLike);
-    /**
-     * Set the northeast corner of the bounding box
-     *
-     * @param ne - a {@link LngLatLike} object describing the northeast corner of the bounding box.
-     */
-    setNorthEast(ne: LngLatLike): this;
-    /**
-     * Set the southwest corner of the bounding box
-     *
-     * @param sw - a {@link LngLatLike} object describing the southwest corner of the bounding box.
-     */
-    setSouthWest(sw: LngLatLike): this;
-    /**
-     * Extend the bounds to include a given LngLatLike or LngLatBoundsLike.
-     *
-     * @param obj - object to extend to
-     */
-    extend(obj: LngLatLike | LngLatBoundsLike): this;
-    /**
-     * Returns the geographical coordinate equidistant from the bounding box's corners.
-     *
-     * @returns The bounding box's center.
-     * @example
-     * ```ts
-     * let llb = new LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
-     * llb.getCenter(); // = LngLat {lng: -73.96365, lat: 40.78315}
-     * ```
-     */
-    getCenter(): LngLat;
-    /**
-     * Returns the southwest corner of the bounding box.
-     *
-     * @returns The southwest corner of the bounding box.
-     */
-    getSouthWest(): LngLat;
-    /**
-     * Returns the northeast corner of the bounding box.
-     *
-     * @returns The northeast corner of the bounding box.
-     */
-    getNorthEast(): LngLat;
-    /**
-     * Returns the northwest corner of the bounding box.
-     *
-     * @returns The northwest corner of the bounding box.
-     */
-    getNorthWest(): LngLat;
-    /**
-     * Returns the southeast corner of the bounding box.
-     *
-     * @returns The southeast corner of the bounding box.
-     */
-    getSouthEast(): LngLat;
-    /**
-     * Returns the west edge of the bounding box.
-     *
-     * @returns The west edge of the bounding box.
-     */
-    getWest(): number;
-    /**
-     * Returns the south edge of the bounding box.
-     *
-     * @returns The south edge of the bounding box.
-     */
-    getSouth(): number;
-    /**
-     * Returns the east edge of the bounding box.
-     *
-     * @returns The east edge of the bounding box.
-     */
-    getEast(): number;
-    /**
-     * Returns the north edge of the bounding box.
-     *
-     * @returns The north edge of the bounding box.
-     */
-    getNorth(): number;
-    /**
-     * Returns the bounding box represented as an array.
-     *
-     * @returns The bounding box represented as an array, consisting of the
-     * southwest and northeast coordinates of the bounding represented as arrays of numbers.
-     * @example
-     * ```ts
-     * let llb = new LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
-     * llb.toArray(); // = [[-73.9876, 40.7661], [-73.9397, 40.8002]]
-     * ```
-     */
-    toArray(): [number, number][];
-    /**
-     * Return the bounding box represented as a string.
-     *
-     * @returns The bounding box represents as a string of the format
-     * `'LngLatBounds(LngLat(lng, lat), LngLat(lng, lat))'`.
-     * @example
-     * ```ts
-     * let llb = new LngLatBounds([-73.9876, 40.7661], [-73.9397, 40.8002]);
-     * llb.toString(); // = "LngLatBounds(LngLat(-73.9876, 40.7661), LngLat(-73.9397, 40.8002))"
-     * ```
-     */
-    toString(): string;
-    /**
-     * Check if the bounding box is an empty/`null`-type box.
-     *
-     * @returns True if bounds have been defined, otherwise false.
-     */
-    isEmpty(): boolean;
-    /**
-     * Check if the point is within the bounding box.
-     *
-     * @param lnglat - geographic point to check against.
-     * @returns `true` if the point is within the bounding box.
-     * @example
-     * ```ts
-     * let llb = new LngLatBounds(
-     *   new LngLat(-73.9876, 40.7661),
-     *   new LngLat(-73.9397, 40.8002)
-     * );
-     *
-     * let ll = new LngLat(-73.9567, 40.7789);
-     *
-     * console.log(llb.contains(ll)); // = true
-     * ```
-     */
-    contains(lnglat: LngLatLike): boolean;
-    /**
-     * Converts an array to a `LngLatBounds` object.
-     *
-     * If a `LngLatBounds` object is passed in, the function returns it unchanged.
-     *
-     * Internally, the function calls `LngLat#convert` to convert arrays to `LngLat` values.
-     *
-     * @param input - An array of two coordinates to convert, or a `LngLatBounds` object to return.
-     * @returns A new `LngLatBounds` object, if a conversion occurred, or the original `LngLatBounds` object.
-     * @example
-     * ```ts
-     * let arr = [[-73.9876, 40.7661], [-73.9397, 40.8002]];
-     * let llb = LngLatBounds.convert(arr); // = LngLatBounds {_sw: LngLat {lng: -73.9876, lat: 40.7661}, _ne: LngLat {lng: -73.9397, lat: 40.8002}}
-     * ```
-     */
-    static convert(input: LngLatBoundsLike): LngLatBounds;
-    /**
-     * Returns a `LngLatBounds` from the coordinates extended by a given `radius`. The returned `LngLatBounds` completely contains the `radius`.
-     *
-     * @param center - center coordinates of the new bounds.
-     * @param radius - Distance in meters from the coordinates to extend the bounds.
-     * @returns A new `LngLatBounds` object representing the coordinates extended by the `radius`.
-     * @example
-     * ```ts
-     * let center = new LngLat(-73.9749, 40.7736);
-     * LngLatBounds.fromLngLat(100).toArray(); // = [[-73.97501862141328, 40.77351016847229], [-73.97478137858673, 40.77368983152771]]
-     * ```
-     */
-    static fromLngLat(center: LngLat, radius?: number): LngLatBounds;
-}