Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@esri/arcgis-to-geojson-utils

Esri17.9kApache-2.01.3.0

Tools to convert ArcGIS JSON geometries to GeoJSON geometries and vica-versa.

arcgis, convert, geo, geojson, geometry

readme

arcgis-to-geojson-utils

npm travis standard

Tools to convert ArcGIS JSON geometries to GeoJSON geometries and vice versa.

Install

npm install @esri/arcgis-to-geojson-utils

Usage

Browser (from CDN)

This package is distributed as a UMD module and can also be used in AMD based systems or as a global under the ArcgisToGeojsonUtils namespace.

<script src="https://unpkg.com/@esri/arcgis-to-geojson-utils"></script>
ArcgisToGeojsonUtils.arcgisToGeoJSON({
    "x":-122.6764,
    "y":45.5165,
    "spatialReference": {
      "wkid": 4326
    }
});

ES6

import { arcgisToGeoJSON } from '@esri/arcgis-to-geojson-utils';
import { geojsonToArcGIS } from '@esri/arcgis-to-geojson-utils';

// parse ArcGIS JSON, convert it to GeoJSON
const geojson = arcgisToGeoJSON({
    "x":-122.6764,
    "y":45.5165,
    "spatialReference": {
      "wkid": 4326
    }
  });

// take GeoJSON and convert it to ArcGIS JSON
const arcgis = geojsonToArcGIS({
  "type": "Point",
  "coordinates": [45.5165, -122.6764]
});

Node.js

const esriUtils = require('@esri/arcgis-to-geojson-utils');

esriUtils.geojsonToArcGIS(/* ... */);
esriUtils.arcgisToGeoJSON(/* ... */);

Thanks to @JeffJacobson, TypeScript typings and tests can be found on npm.

We recommend using --moduleResolution Node to ensure the compiler recognizes the types.

Issues

Find a bug or want to request a new feature? Please let us know by submitting an issue.

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.

Ports

Project Language Status Maintainer
arcgis2geojson Python Incomplete @chris48s

Licensing

Copyright © 2015-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 file.

changelog

Change log

All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.

Unreleased

1.3.0 - 2018-07-06

Added

  • capability to convert ArcGIS Extent/Envelopes to GeoJSON Polygon. (🙏CorinChappy🙏 #34)

1.2.0 - 2018-03-29

Added

  • its now possible to convert an array of ArcGIS JSON features to a GeoJSON FeatureCollection. (🙏chris48s🙏 #28)

1.1.1 - 2018-03-08

Fixed

  • ensure ES6 module is publicized in package.json as the module for Rollup and other modern bundlers.

1.1.0

Changed

  • Ring-winding order for GeoJSON Polygons prescribed by RFC 7946 is now enforced. (🙏chris48s🙏 #22)

1.0.5

Changed

  • Maintain z value when translating from ArcGIS to GeoJSON

1.0.4

Changed

  • published package in @esri namespace on npm.

Fixed

  • ensure built version of lib can be minified using uglify-js. #17 thanks @chidg!

1.0.3

Fixed

  • ensured /test, the bundled .zip and other unnecessary files are omitted from npm release

1.0.2

Added

  • default export

Fixed

  • pass through a null geometry when invalid input is encountered

1.0.1

Fixed

  • first npm release

1.0.0

  • First Release