Locates a feature along a line by using measures (eg. timestamp) stored as an additional property ("dimension") of the line. The "dimension" must follow Mapbox's geojson-coordinateProperties proposal (https://github.com/mapbox/geojson-coordinate-properties). Similar to LocateFeaturesAlongRoutes in ArcGIS, but one measure at a time.

• Locating pictures along a GPX track (X, Y, Z, timestamp) using a "Date and Time" EXIF field.
• Locating incidents along a pipeline or road by using an arbitrary measure system.

  var locate_m = require('./');

  var line = {
      "type": "Feature",
      "geometry": {
          "type": "LineString",
          "coordinates": [
              [0, 0],
              [30, 0],
              [60, 30]
          ]
      },
      "properties": {
          "coordinateProperties": {
              // this is one dimension...
              "measures": [
                  0,
                  10,
                  20
              ]
          }
      }
  };

  var result = locate_m(line, 15, 'measures');

  // {
  //        type: 'Feature',
  //        geometry: {
  //            type: 'Point',
  //            coordinates: [ 45, 15 ]
  //        },
  //        properties: {
  //            locate_measure: 15
  //        }
  // }

Returns Feature.<Point>. Measure is also returned in Feature.properties.locate_measure.

Returns null if measure is smaller or larger than measures at start or end of line.

Throws an Exception if dimension is not present in coordinateProperties, or if measures are not increasing from vertex to vertex.

$ npm test