@programmerare/sweden_crs_transformations
Version:
TypeScript/JavaScript library for transformation of geographic coordinates between WGS84 and the Swedish coordinate reference systems SWEREF99 and RT90
133 lines • 7.42 kB
JavaScript
;
/*
* https://github.com/TomasJohansson/sweden_crs_transformations_4typescript
* Copyright (c) Tomas Johansson , http://www.programmerare.com
* The code in this 'sweden_crs_transformations_4typescript' library is licensed with MIT.
* The library is based on the C#.NET library 'sweden_crs_transformations_4net' (https://github.com/TomasJohansson/sweden_crs_transformations_4net)
* and the Dart library 'sweden_crs_transformations_4dart' (https://github.com/TomasJohansson/sweden_crs_transformations_4dart)
* Both above libraries are based on the C#.NET library 'MightyLittleGeodesy' (https://github.com/bjornsallarp/MightyLittleGeodesy/)
* which is also released with MIT.
* License information about 'sweden_crs_transformations_4typescript' and 'MightyLittleGeodesy':
* https://github.com/TomasJohansson/sweden_crs_transformations_4typescript/blob/typescript_SwedenCrsTransformations/LICENSE
*/
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
var crs_projection_1 = __importDefault(require("./crs_projection"));
var transformer_1 = __importDefault(require("./transformation/transformer"));
/** Coordinate, defined by the three parameters for the constructor. */
var CrsCoordinate = /** @class */ (function () {
/**
* Private constructor. Client code must instead use the factory constructors.
*
* @param crsProjection - The coordinate reference system that defines the location
* together with the other two properties (xLongitude and yLatitude).
* @param yLatitude - The coordinate value representing the latitude or Y or Northing.
* @param xLongitude - The coordinate value representing the longitude or X or Easting.
*/
function CrsCoordinate(crsProjection, yLatitude, xLongitude) {
this.crsProjection = crsProjection;
this.yLatitude = yLatitude;
this.xLongitude = xLongitude;
}
/**
* Static factory method for creating an instance.
*
* @param epsgNumber - The coordinate reference system that defines the location
* together with the other two parameters (xLongitude and yLatitude).
* @param yLatitude - The coordinate position value representing the latitude or Y or Northing
* @param xLongitude - The coordinate position value representing the longitude or X or Easting
*/
CrsCoordinate.createCoordinateByEpsgNumber = function (epsgNumber, yLatitude, xLongitude) {
var crsProjection = crs_projection_1.default.getCrsProjectionByEpsgNumber(epsgNumber);
return CrsCoordinate.createCoordinate(crsProjection, yLatitude, xLongitude);
};
/**
* Static factory method for creating an instance.
*
* @param crsProjection - The coordinate reference system that defines the location
* together with the other two parameters.
* @param yLatitude - The coordinate position value representing the latitude or Y or Northing
* @param xLongitude - The coordinate position value representing the longitude or X or Easting
*/
CrsCoordinate.createCoordinate = function (crsProjection, yLatitude, xLongitude) {
return new CrsCoordinate(crsProjection, yLatitude, xLongitude);
};
// -----------------------------------------------
/**
* Transforms the coordinate to another coordinate reference system.
* @param targetCrsProjection - The coordinate reference system that you want to transform to.
*/
CrsCoordinate.prototype.transform = function (targetCrsProjection) {
return transformer_1.default.transform(this, targetCrsProjection);
};
/**
* Transforms the coordinate to another coordinate reference system.
*
* @param targetEpsgNumber - The coordinate reference system that you want to transform to.
*/
CrsCoordinate.prototype.transformByEpsgNumber = function (targetEpsgNumber) {
var targetCrsProjection = crs_projection_1.default.getCrsProjectionByEpsgNumber(targetEpsgNumber);
return this.transform(targetCrsProjection);
};
// Two methods/properties from Dart below ('operator ==' and 'hashCode')
// @override
// bool operator ==(Object other) {
// if (identical(this, other)) return true; // Checks whether two references are to the same object.
// return (other is CrsCoordinate) &&
// crsProjection == other.crsProjection &&
// xLongitude == other.xLongitude &&
// yLatitude == other.yLatitude;
// }
// // Regarding the missing (i.e. not implemented or overridden here) method "!=" it is "just syntactic sugar.
// // For example, the expression e1 != e2 is syntactic sugar for !(e1 == e2).""
// // quoted from https://dart.dev/guides/language/language-tour#methods
// @override
// int get hashCode {
// var result = xLongitude.hashCode;
// result = 31 * result + yLatitude.hashCode;
// result = 31 * result + crsProjection.hashCode;
// return result;
// }
/**
* Returns a string representation of the object.
* See also the method {@link defaultToStringImplementation} or the type {@link CrsCoordinateToString}
* and the method {@link setToStringImplementation} if you want to change to a custom implementation of toString.
* @override
*/
CrsCoordinate.prototype.toString = function () {
return CrsCoordinate._toStringImplementation(this);
};
/**
* Renders a coordinate as a string.
* @param coordinate - The coordinate that should be rendered as a string.
* @returns See below two examples of the string that can be returned:
* "CrsCoordinate [ Y: 6579457.649 , X: 153369.673 , CRS: SWEREF_99_18_00 ]"
* "CrsCoordinate [ Latitude: 59.330231 , Longitude: 18.059196 , CRS: WGS84 ]"
*/
CrsCoordinate.defaultToStringImplementation = function (coordinate) {
var isWgs84 = coordinate.crsProjection.isWgs84();
var yOrLatitude = isWgs84 ? 'Latitude' : 'Y';
var xOrLongitude = isWgs84 ? 'Longitude' : 'X';
return "CrsCoordinate [ " + yOrLatitude + ": " + coordinate.yLatitude + " , " + xOrLongitude + ": " + coordinate.xLongitude + " , CRS: " + coordinate.crsProjection.getAsString() + " ]";
};
/**
* Sets a custom method to be used for rendering an instance when the 'toString' method is used.
* @param toStringImplementation - The custom method
*/
CrsCoordinate.setToStringImplementation = function (toStringImplementation) {
CrsCoordinate._toStringImplementation = toStringImplementation;
};
/**
* Sets the default method to be used for rendering an instance when the 'toString' method is used.
*/
CrsCoordinate.setToStringImplementationDefault = function () {
CrsCoordinate._toStringImplementation = CrsCoordinate.defaultToStringImplementation;
};
/** See also {@link CrsCoordinateToString} */
CrsCoordinate._toStringImplementation = CrsCoordinate.defaultToStringImplementation;
return CrsCoordinate;
}());
exports.default = CrsCoordinate;
//# sourceMappingURL=crs_coordinate.js.map