@mapbox/osm-compare

osm-compare

Compare functions are small atomic functions that are designed identify what changed during a feature edit on OpenStreetMap. Compare functions can be broadly split up into two categories:

• Property (tags) checking compare function
• Geometry checking compare functions

Compare functions take as inputs the following:

• oldVersion - GeoJSON of the feature's old version
• newVersion - GeoJSON of the feature's new version

Compare functions output the following:

• result - Object containing key value pairs representing findings of the compare function or an empty object.

# Format of compare function result where value can be primary data types or objects
{
    'result:comparator_name': value,
    'message': Any custom message which corresponds to the catch
}

# Format of compare function if no result, (default)
false

Install

# Install osm-compare from the Mapbox namespace.
npm install @mapbox/osm-compare

Docs

• How do I create a new compare function
• Sample compare function
• What does each compare function do

How do I build an npm package?

• We use Semantic Versioning Specification for versioning releases.
• Create an appropriate version of the npm package with npm version [major|minor|patch].
• Push the package tag commit with git push --tags
• Publish the NPM package with npm publish

Changelog

[9.4.1] - 2021-05-16

Fixed

• Don't throw error if the user information is not available

Updated

• tap library update to version 15.0.9