Skip to content

Makes working with GeoSpatial Extents Easy. A simple chainable extent class.

License

Notifications You must be signed in to change notification settings

DanielJDufour/geo-extent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

geo-extent

Simple, Modern Geospatial Bounding Boxes

features

  • immutable: all functions return a new GeoExtent
  • chainable: ex: extent.reproj(3857).crop(other).toGeoJSON()
  • universal input: works with bbox arrays, xy corner points, and Leaflet bounds
  • interoperability: integrates well with Leaflet, OpenLayers, and ESRI
  • precise: avoids some common floating-point arithmetic issues by using preciso
  • typescript: includes type definitions

install

npm install geo-extent

basic usage

import { GeoExtent } from 'geo-extent';

// extent of web mercator tile for x=964, y=1704, and z=12
const tile = new GeoExtent([-10605790.548624776, 3355891.2898323783, -10596006.609004272, 3365675.2294528796], { srs: 3857 });

// convert tile extent to Latitude/Longitude
const latLngBBox = tile.reproj(4326).bbox;
// latLngBBox is [-95.27343750000001, 28.84467368077178, -95.185546875, 28.921631282421277]

// extent of a Cloud-Optimized GeoTIFF (COG) in UTM Projection 32615
const cog = new GeoExtent([259537.6, 3195976.8000000003, 281663.2, 3217617.6], { srs: 32615 });

// partial is the part of the tile that overlaps the extent of the COG
const partial = tile.crop(cog);
// partial is equivalent to GeoExtent([-10605790.548624776, 3358990.12945602, -10601914.152717294, 3365675.2294528796], 3857);

documentation

For more functions and examples, please consult the documentation at https://github.com/DanielJDufour/geo-extent/tree/main/docs

used by