aspernaturalias 1.0.0

package/packages/arcgis-rest-routing/README.md

@@ -0,0 +1,75 @@
+[![npm version][npm-img]][npm-url]
+[![build status][travis-img]][travis-url]
+[![gzip bundle size][gzip-image]][npm-url]
+[![Coverage Status][coverage-img]][coverage-url]
+[![apache licensed](https://img.shields.io/badge/license-Apache-green.svg?style=flat-square)](https://raw.githubusercontent.com/Esri/arcgis-rest-js/master/LICENSE)
+
+[npm-img]: https://img.shields.io/npm/v/@esri/arcgis-rest-routing.svg?style=flat-square
+[npm-url]: https://www.npmjs.com/package/@esri/arcgis-rest-routing
+[travis-img]: https://img.shields.io/travis/Esri/arcgis-rest-js/master.svg?style=flat-square
+[travis-url]: https://travis-ci.org/Esri/arcgis-rest-js
+[gzip-image]: https://img.badgesize.io/https://unpkg.com/@esri/arcgis-rest-routing/dist/umd/routing.umd.min.js?compression=gzip
+[coverage-img]: https://codecov.io/gh/Esri/arcgis-rest-js/branch/master/graph/badge.svg
+[coverage-url]: https://codecov.io/gh/Esri/arcgis-rest-js
+
+# @esri/arcgis-rest-routing
+
+> Routing helpers for [`@esri/arcgis-rest-request`](https://github.com/Esri/arcgis-rest-js).
+
+### Example
+
+```bash
+npm install @esri/arcgis-rest-request
+npm install @esri/arcgis-rest-common
+npm install @esri/arcgis-rest-routing
+```
+
+```js
+solveRoute({
+  stops: [
+    [-117.195677, 34.056383],
+    [-117.918976, 33.812092],
+  ],
+  authentication
+})
+.then(response)
+// {routes: {features: [{attributes: { ... }, geometry:{ ... }}]}}
+```
+
+### [API Reference](https://esri.github.io/arcgis-rest-js/api/routing/)
+
+### Issues
+
+If something isn't working the way you expected, please take a look at [previously logged issues](https://github.com/Esri/arcgis-rest-js/issues) first.  Have you found a new bug?  Want to request a new feature?  We'd [**love**](https://github.com/Esri/arcgis-rest-js/issues/new) to hear from you.
+
+If you're looking for help you can also post issues on [GIS Stackexchange](http://gis.stackexchange.com/questions/ask?tags=esri-oss).
+
+### Versioning
+
+For transparency into the release cycle and in striving to maintain backward compatibility, @esri/arcgis-rest-js is maintained under Semantic Versioning guidelines and will adhere to these rules whenever possible.
+
+For more information on SemVer, please visit <http://semver.org/>.
+
+### Contributing
+
+Esri welcomes contributions from anyone and everyone. Please see our [guidelines for contributing](CONTRIBUTING.md).
+
+### [Changelog](https://github.com/Esri/arcgis-rest-js/blob/master/CHANGELOG.md)
+
+### License
+
+Copyright &copy; 2018 Esri
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+> http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+A copy of the license is available in the repository's [LICENSE](../../LICENSE) file.

package/packages/arcgis-rest-routing/package-lock.json

@@ -0,0 +1,11 @@
+{
+	"requires": true,
+	"lockfileVersion": 1,
+	"dependencies": {
+		"tslib": {
+			"version": "1.9.3",
+			"resolved": "https://registry.npmjs.org/tslib/-/tslib-1.9.3.tgz",
+			"integrity": "sha512-4krF8scpejhaOgqzBEcGM7yDIEfi0/8+8zDRZhNZZ2kjmHJ4hv3zCbQWxoJGz1iw5U0Jl0nma13xzHXcncMavQ=="
+		}
+	}
+}

package/packages/arcgis-rest-routing/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@esri/arcgis-rest-routing",
+  "version": "2.0.4",
+  "description": "Routing helpers for @esri/arcgis-rest-js",
+  "main": "dist/node/index.js",
+  "unpkg": "dist/umd/routing.umd.js",
+  "module": "dist/esm/index.js",
+  "js:next": "dist/esm/index.js",
+  "sideEffects": false,
+  "types": "dist/esm/index.d.ts",
+  "license": "Apache-2.0",
+  "files": [
+    "dist/**"
+  ],
+  "dependencies": {
+    "@esri/arcgis-rest-types": "^2.0.4",
+    "tslib": "^1.9.3"
+  },
+  "devDependencies": {
+    "@esri/arcgis-rest-auth": "^2.0.4",
+    "@esri/arcgis-rest-request": "^2.0.4"
+  },
+  "peerDependencies": {
+    "@esri/arcgis-rest-auth": "^2.0.0",
+    "@esri/arcgis-rest-request": "^2.0.0"
+  },
+  "scripts": {
+    "prepare": "npm run build",
+    "build": "npm run build:node && npm run build:umd && npm run build:esm",
+    "build:esm": "tsc --module es2015 --outDir ./dist/esm --declaration",
+    "build:umd": "rollup -c ../../umd-base-profile.js && rollup -c ../../umd-production-profile.js",
+    "build:node": "tsc --module commonjs --outDir ./dist/node",
+    "dev:esm": "tsc -w --module es2015 --outDir ./dist/esm --declaration",
+    "dev:umd": "rollup -w -c ../../umd-base-profile.js",
+    "dev:node": "tsc -w --module commonjs --outDir ./dist/node"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Esri/arcgis-rest-js.git",
+    "directory": "packages/arcgis-rest-routing"
+  },
+  "contributors": [
+    {
+      "name": "Gavin Rehkemper",
+      "email": "gavin@gavinr.com"
+    }
+  ],
+  "bugs": {
+    "url": "https://github.com/Esri/arcgis-rest-js/issues"
+  },
+  "homepage": "https://github.com/Esri/arcgis-rest-js#readme",
+  "keywords": [
+    "typescript",
+    "promise",
+    "fetch",
+    "arcgis",
+    "esri",
+    "ES6"
+  ]
+}

package/packages/arcgis-rest-routing/src/helpers.ts

@@ -0,0 +1,16 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { IRequestOptions } from "@esri/arcgis-rest-request";
+
+// https always
+export const ARCGIS_ONLINE_ROUTING_URL =
+  "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World";
+
+// nice to have: verify custom endpoints contain 'NAServer' and end in a '/'
+export interface IEndpointOptions extends IRequestOptions {
+  /**
+   * Any ArcGIS Routing service (example: https://sampleserver3.arcgisonline.com/ArcGIS/rest/services/Network/USA/NAServer/Route/ ) to use for the routing service request.
+   */
+  endpoint?: string;
+}

package/packages/arcgis-rest-routing/src/index.ts

@@ -0,0 +1,11 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+export * from "./solveRoute";
+export * from "./helpers";
+export {
+  ILocation,
+  ISpatialReference,
+  IPoint,
+  IFeature
+} from "@esri/arcgis-rest-types";

package/packages/arcgis-rest-routing/src/solveRoute.ts

@@ -0,0 +1,124 @@
+/* Copyright (c) 2018 Environmental Systems Research Institute, Inc.
+ * Apache-2.0 */
+
+import { request, cleanUrl } from "@esri/arcgis-rest-request";
+
+import {
+  ILocation,
+  ISpatialReference,
+  IPoint,
+  IFeature
+} from "@esri/arcgis-rest-types";
+
+import { ARCGIS_ONLINE_ROUTING_URL, IEndpointOptions } from "./helpers";
+
+export interface ISolveRouteOptions extends IEndpointOptions {
+  /**
+   * Specify two or more locations between which the route is to be found.
+   */
+  stops: Array<
+    IPoint | ILocation | [number, number] | [number, number, number]
+  >;
+}
+
+export interface ISolveRouteResponse {
+  messages: string[];
+  checksum: string;
+  routes: {
+    fieldAliases: object;
+    geometryType: string;
+    spatialReference: ISpatialReference;
+    features: IFeature[];
+  };
+  directions?: Array<{
+    routeId: number;
+    routeName: string;
+    summary: object;
+    features: IFeature[];
+  }>;
+}
+
+function isLocationArray(
+  coords: ILocation | IPoint | [number, number] | [number, number, number]
+): coords is [number, number] | [number, number, number] {
+  return (
+    (coords as [number, number]).length === 2 ||
+    (coords as [number, number, number]).length === 3
+  );
+}
+
+function isLocation(
+  coords: ILocation | IPoint | [number, number] | [number, number, number]
+): coords is ILocation {
+  return (
+    (coords as ILocation).latitude !== undefined ||
+    (coords as ILocation).lat !== undefined
+  );
+}
+
+/**
+ * ```js
+ * import { solveRoute } from '@esri/arcgis-rest-routing';
+ * //
+ * solveRoute({
+ *   stops: [
+ *     [-117.195677, 34.056383],
+ *     [-117.918976, 33.812092],
+ *    ],
+ *    authentication
+ * })
+ *   .then(response) // => {routes: {features: [{attributes: { ... }, geometry:{ ... }}]}
+ * ```
+ * Used to find the best way to get from one location to another or to visit several locations. See the [REST Documentation](https://developers.arcgis.com/rest/network/api-reference/route-synchronous-service.htm) for more information.
+ *
+ * @param requestOptions Options to pass through to the routing service.
+ * @returns A Promise that will resolve with routes and directions for the request.
+ * @restlink https://developers.arcgis.com/rest/network/api-reference/route-synchronous-service.htm
+ */
+export function solveRoute(
+  requestOptions: ISolveRouteOptions
+): Promise<ISolveRouteResponse> {
+  const options: ISolveRouteOptions = {
+    endpoint: requestOptions.endpoint || ARCGIS_ONLINE_ROUTING_URL,
+    params: {},
+    ...requestOptions
+  };
+
+  // the SAAS service does not support anonymous requests
+  if (
+    !requestOptions.authentication &&
+    options.endpoint === ARCGIS_ONLINE_ROUTING_URL
+  ) {
+    return Promise.reject(
+      "Routing using the ArcGIS service requires authentication"
+    );
+  }
+
+  const stops: string[] = requestOptions.stops.map(coords => {
+    if (isLocationArray(coords)) {
+      return coords.join();
+    } else if (isLocation(coords)) {
+      if (coords.lat) {
+        return (
+          coords.long + "," + coords.lat + (coords.z ? "," + coords.z : "")
+        );
+      } else {
+        return (
+          coords.longitude +
+          "," +
+          coords.latitude +
+          (coords.z ? "," + coords.z : "")
+        );
+      }
+    } else {
+      return coords.x + "," + coords.y + (coords.z ? "," + coords.z : "");
+    }
+  });
+  options.params.stops = stops.join(";");
+
+  return request(`${cleanUrl(options.endpoint)}/solve`, options);
+}
+
+export default {
+  solveRoute
+};