jgravois/lrm-esri

use Esri's hosted routing service in Leaflet to generate walk, car and truck routes/directions

Leaflet Routing Machine - Esri plugin

enables walk, drive and truck routing using Esri's hosted service.

Demo

Check out the live demo.

Usage

<script src="./lrm-esri.js"></script>

/*
additional profiles:
Walking, Trucking, Rural Driving, Walking Distance, Trucking Distance, Driving Distance and Rural Driving Distance
*/
var control = L.Routing.control({
	router: L.Routing.esri({
    liveTraffic: true,
    profile: 'Driving'
  })
}).addTo(map);

Features

Esri's hosted routing service can find the shortest driving, truck and walk time or distance for up to 150 input stops. It is able to incorporate both live and historic traffic and can reorder input stops to find the optimal sequence.

Authentication

Use a proxied service

You can allow anonymous users to get directions in your application by leveraging a proxied service - live demo

1. Sign up for a free developer account
2. Create your own proxied service url
3. supply the url in the provider constructor

var control = L.Routing.control({
  router: L.Routing.esri({
    url: '<your proxied service url>'
  })
}).addTo(map);

When credentials are embedded, 1250 requests/month are provided for free. Deployment packs are available to help you scale.

Use OAuth2

You can also use OAuth2 and bill routing charges directly to existing ArcGIS users - live demo

1. Sign up for a free developer account
2. Create and register a new application
3. Reference your clientID in your app and configure a redirectUri
4. after the user signs in, supply their token in the provider constructor (more info here)

var control = L.Routing.control({
  router: L.Routing.esri({
    token: '<user token>'
  })
}).addTo(map);

Development Instructions

If you'd like to inspect and modify the source code, follow the instructions below to set up a local development environment.

1. Fork and clone
2. cd into the lrm-esri folder
3. Install the package.json dependencies by running npm install
4. Run npm start from the command line. This will recompile minified source in the dist directory, launch a tiny webserver and begin watching the raw source for changes.
5. Run http://localhost:8080/examples/index.html to check out your changes
6. Create a pull request

Dependencies

• leaflet
• leaflet-routing-machine
• cors-lite
• esri-leaflet

Resources

• ArcGIS for Developers
• REST documentation for routing service

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.

Caveats

Many Esri routing service features have not been implemented

• barriers
• route optimization
• driving, trucking and walking distance
• time windows
• routing for emergency vehicles

Licensing

Copyright © 2017 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.

lrm-esri's Issues

remove 'Height Restriction'

lrm-esri/src/esriRouter.js

Lines 351 to 353 in 5f82e3d

	if (this.options.vehicleHeight) {
	completeServiceUrl += "&restrictionAttributeNames=Height Restriction&attributeParameterValues=[{'attributeName': 'Height Restriction','parameterName': 'Vehicle Height (meters)','value': " + this.options.vehicleHeight + '}]';
	}

i helped a user on Slack the other day and quickly stubbed in support for a new constuctor option called vehicleHeight which expects a number in meters.

this should be removed for two reasons

1. travelMode trumps external attribute restrictions
2. setting just one new restrictionAttributeNames wipes out the defaults (and leads to strange solutions)

Avoid Carpool Roads, Avoid Express Lanes, Avoid Gates, Avoid Private Roads, Avoid Unpaved Roads, Driving an Automobile, Roads Under Construction Prohibited, Through Traffic Prohibited.

http://resources.arcgis.com/en/help/arcgis-rest-api/index.html#/Route_service_with_synchronous_execution/02r300000036000000/

doc OAuth example too

Direction menu not showing

I am trying to get this to work and it draws the menu outline but puts nothing on it. Here is the link: https://map.drakefletcher2.repl.co/
here is the code:
https://replit.com/@DrakeFletcher2/Map
Am I doing anything wrong?

Routing error: {status: -3, message: "TypeError: Cannot read properties of undefined (reading 'features')"}

I got the following error. I don't know how to solve it or help me.

Not work demo.

Currently, Demo site doesn't works. Please check it.

Can the results of Network Analysis display as Leaflet Routing Machine style ?

Hello !
I'm trying to show the results of Network Analysis(VRP) in the style of Leaflet Routing Machine, as shown in the figure, but I don't know how. I wonder if this can be achieved ?

I really appreciate if you can give me some suggestions or example that solves this.
Sorry for the inconveniences and thank you in advance.