1.3.1

This minor release repairs options in the show command.

1.3.0

v1.3 of the HERE CLI is here! Bugs have been tracked down and features have been hoisted up. We clarified lots of the inline documentation -- check it out with -h. And as for the new features:

🔎🗺🔍 Spatial Search 🔎🌏🔍

You can now select a set features within a radius around a point, using --spatial in the show command:

here xyz show spaceID --spatial --center "37.74,-122.43" --radius=100 -w

And as if that were not exciting enough, you can also select features from one space that fall within a polygon from another space! Imagine you had a space that had postal codes as the feature ID:

here xyz show space_with_points --spatial --feature space_with_zip_codes,94104 -w

➕➕➕ CSV Join ➕➕➕

Virtual Spaces are fun, but it's sometime laborious to get the data you need into XYZ, especially when it's a CSV table with data and IDs but no coordinates (think Census tables). But now you can use the new join command to dynamically associate a CSV to space with geometries with those same IDs!

here xyz join space_with_geometries -f table_with_ids.csv -k unique_id

This means you can pour the properties from many CSVs into the polygons of one existing space and access them through the new virtual space IDs.

Note that uses the same CSV import options (delimiter, quotes, string-fields).

You can also update a CSV space and the Virtual Space will dynamically update.

🏃‍♀️🏃‍♂️👟 Import GPX files 🚴‍♀️🚴‍♂️🚲

If you run or bike, you probably know what GPX traces are, and you'll be excited to know we can now import them into XYZ aka Data Hub! Just reference the file in here xyz upload my.gpx and we will convert it into delicious GeoJSON using @roberto-butti's sweet code. Thanks for the PR, Roberto!

🎉🎉🎉Other interesting enhancements 🎉🎉🎉

• Features are now written to XYZ spaces using PATCH instead of POST, meaning you can make more granular edits to your features.

• It turns out point field columns are not always written as (lat,lon) but sometimes are (lon,lat) and we can now deal with that.

• You can now add --token to most commands, and presuming you have the appropriate permissions, you can do things to/with your friends' spaces.

• We are now using the d3-Delaunay library for Voronoi polygons.

• We check for troublesome characters in tags that break URLs, like & and + and ,

• Users can now adjust the cacheTTL of a space using config --cacheTTL

• We are deprecating here xyz describe since here xyz config --stats does a much better job.

Thanks for watching, and let us know what you see in the issues!

1.2.0

Lots of enhancements and bug fixes, including the integration of some GIS functions!

🛠🔧🔨Command Line GIS 🛠🔧🔨

We've integrated some functions from turf.js so you can modify your features and spaces in a variety of interesting ways!

〰add length to lines
🔳 add area to polygons
🔘 generate centroids of polygons (and write them to either the same space, or a new space)
🔼 generate tin (Triangulated Irregular Network,, aka Delauney triangles) from a space containing points
⧎⧎ generate voronoi triangles from a space containing points

Everyone has their favorite GIS function -- if yours isn't included, take a look at how we did it and make a pull request, or file an issue.

🎁🎁🎁Read from / write to other users spaces 🎁🎁🎁

As we've noted before, sharing is caring. If you and your friends like to share read and write tokens, you can read and get info from and upload to each others' spaces using the --token option:

here xyz show spaceID --token
here xyz upload spaceID -f your.geojson --token
here xyz config spaceID --stats --token

✂️✂️✂️ More feedback when clearing and deleting spaces 💥💥💥

When clearing or deleting spaces, we want to make it absolutely clear which space you're working on. Like us, you probably don't have all your space IDs memorized, so we though it would be a good idea to add information about the space, including the name, description, and feature count in the "are you sure" prompt.

1.1.1

🗝🗝🗝 This minor release contains enhancements involving tokens and authentication. 🔑🔑🔑

1. Added support for Location Services API Key authentication.

2. Added server side hexbin clustering capability to tokens generated when viewing space on web via CLI.

3. Support for changes in the Hub API.

1.1.0

Lots of enhancements in version 1.1.0 of the HERE CLI aimed at making your life easier.

⬆️⬆️⬆️Upload ⏫⏫⏫

• we now echo the space ID after an upload finishes, making it easier to find and copy
• upload progress is less chatty, with percentage updated on the same line
• while uploading a CSV, if a row does not have any coordinates, we assign it a null geometry and tag it as null_island (meaning you can use tags to access and repair these records)
• lots of streaming enhancement
• more reliable shapefile conversion and reprojection
• custom delimiters were breaking streaming
• property-based tags are now only written as property@value

🕴🕴🕴XYZ Pro 🕴🕴🕴

• config is more useful and powerful
• the tagrules and searchable commands have been moved under config
• more useful titles and descriptions of Virtual Spaces

⬢⬡⬢ Hexbins ⬢⬡⬢

• more reliable hexbinning of large spaces (>10 GB)
• you can now hexbin down to zoom 17-18 (useful for aggregating road / probe data)
• better structuring of objects (property names are added to subcounts)
• fixing issues when existing hexbin space belongs to another user, or if spaces are shared
• better bbox support, especially with negative lats/lons

🖋🖊🖌Other🖋🖊🖌

• Nicer table formatting

1.0.2

Do you like Shapefiles and CSVs? We've made it even easier to import them into your XYZ spaces using the HERE CLI. We also implemented Rule Based Tags and enhanced hexbins.

Along with general bug fixes and improvements, we edited and improved the internal help and added nice formatting to tables.

🛠🔧🔩 Import more Shapefiles 🛠🔧🔩

Convert even more kinds of shapefiles! California State Plane? Tokyo / UTM zone 54N? We peek inside the prj file and convert the CRS if it's not WGS84 (thanks PROJ!)

🔤👉🔢 CSV import enhancements 🔤👉🔢

• Latitudes and longitudes are vast, as are the names of their columns. If we don't recognize yours, we let you select them.
• When importing a CSV, if something looks like a number, we save it as a number (unless you tell us it shouldn't be a number -- FIPS and ZIP codes starting with 0, rejoice!) And it's true that we save booleans properly.

📋☑️📐 Rule Based Tags (XYZ Pro) 📋☑️📐

We've introduced a new way to generate tags based on rules when you upload data to an XYZ space using the new tagrule command:

here xyz tagrules spaceID --add

You'll be asked to name a tag, and then enter a rule in the same p.propertyname syntax as Property Search:

node bin/here.js xyz tagrules SPACEID --add
Starting to add a new synchronous rule to automatically tag features..
? Enter a tag name you would like to assign :  fast
Please enter condition(s) for the auto tagging your features with  `fast` e.g. "f.id == 123 || (p.country=='USA' & p.count<=100)"
? condition :   p.velocity>25
tagrules updated successfully!

You can view, edit, and add more rules for a space:

$ node bin/here.js xyz tagrules uZHFctY1 --view
tag_name  mode  auto_tag_condition
--------  ----  ------------------
fast      sync  p.velocity>25     

Note that these tags only get added to features when data is uploaded. Applying rules to data already in a space is under development.

⬢⬡⬢ Hexbins ⬢⬡⬢

Sharing is caring

We've added more meaningful descriptions to the descriptions of XYZ hexbin spaces, including the ID of the source space. And since it's nice to share, we also made it possible to generate hexbins out of shared spaces or another user's space if you have a read token. You can also make a hexbin space in a friend's account if they give you a write token.

Quantity has a quality all its own

We thought it would be useful to let you add up the values of a property (presuming it's a quantitative value). Just specify the property you want to add up with -a:

here xyz hexbin SPACEID -a propertyname_that_is_quantitative

This will generate new properties in each hexbin and centroid called sum and maxSum in addition to the count and maxCount.

XYZ Pro Features Beta Release 1.0.1

This release includes the following changes:

1. Change in the XYZ Pro Beta Terms and Conditions URL.
2. Improvements and bug fixes for XYZ features.

XYZ Pro Features Beta

This rather significant release provides access to exciting new features in the API:

🔎🔎🔎Property Search 🔍🔍🔍

Property Search allows users to filter data by requesting features from the XYZ API based on the values of their properties. Only need buildings taller that 100 feet, or just addresses in one county? The XYZ Hub will automatically track and index these properties as you upload them, making it easy and fast to download just what you need.

You can access property search with -s and operators -- here xyz show spaceID -s "p.property_name>value"

Note that in a url, the arguments are =, !=, =gt=, =gte=, =lt=, =lte=.

Properties are automatically indexed depending on their count and value.

✂️✂️✂️Property Filter ✂️✂️✂️

We've all been there -- you have a lot of properties in your features. Too many, probably. If only you could somehow... filter them, and only return what you need with your geometry.

We're here for you with -p -- even if you have 100 properties, here xyz show -p p.property1,p.property2 will just return a feature with a geometry and those properties you carefully select.

❇️❇️❇️Virtual Spaces ❇️❇️❇️

Virtual Spaces give users access to multiple spaces with one ID. Group lets you bundle your spaces together, and changes get written back to their original spaces. Associate lets you make your own personal edits to a shared space or one with public data, merging the properties of objects with the same feature ID.

here xyz virtualize -a|-g space1,space2

📐📐📐Schema Validation 📏📏📏

Everyone needs validation, and so does your data. Upload a JSON Schema file to describe your data formats and ensure quality data in your XYZ Spaces.

here xyz create -s schema.json

⬢⬡⬢ Hexbins ⬢⬡⬢

Hexbins are a data simplification method that makes it feasible to visualize large datasets at low zoom levels (continent, country, state/province). A series of hexagon grids are created and the points that fall inside each are counted and written to a new space. These hexagons or their centroids can be quickly displayed in place of the raw data.

Learn more via here xyz hexbin -h

Note: reading from and writing to another user's space, and reading via bbox, are works in progress.

🔧🔧🔧 Space Configuration 🔧🔧🔧

Behold the new here xyz config command which not only lets you get data and statistics about your space, but edit and make changes to space metadata.

here xyz config spaceID
here xyz config spaceID --stats

0.2.6-alpha

This is an alpha release for the following new feature:

1. Support for creating hexbins.

0.2.5

🔨IMPROVED 🔨

do,you,like,CSVs? We love them:

• enhanced CSV import options thanks to @toonvanstrijp!

  • some sweet regexing to parse out coordinates where lat,lon is in a single field using -w fieldname
  • don't like commas? are semicolons your thing? select your fancy CSV delimiter using -d ';'
  • select CSV quote style using -q

• if your CSV ends in .txt and you can't change it (probably because it's online), we've got you covered

• extra whitespace is now trimmed out of CSVs

And in non-CSV news:

• more graceful handling of login errors