@geodir/geodir-js
v0.1.13
Published
Geodir Base
Downloads
5
Readme
JavaScript client for the Geodir API
This project offers JavaScript clients and examples for the Geodir API.
Try the live examples here.
Also see how we integrated the Routing and the Geocoding API to build a fully featured maps application called Geodir Maps
Getting Started
CDN
You can use the hosted js client by adding it to your HTML like this:
<script src="/dist/geodir-js.js"></script>
You can then use it like this:
<script>
window.onload = function() {
var geodir = new GeodirAPI.Routing({
key: "[Sign-up for free and get your own key: https://www.geodir.co/]",
vehicle: "car",
elevation: false
});
geodir.addPoint(new GRInput(47.400905, 8.534317));
geodir.addPoint(new GRInput(47.394108, 8.538265));
geodir.doRequest()
.then(function(json) {
// Add your own result handling here
console.log(json);
})
.catch(function(err) {
console.error(err.message);
});
};
</script>
NPM
Install the lib with npm:
npm install @geodir/geodir-js --save
You can either require the whole client enabling you to use every GraphHopper API, but you can also only require the pieces you need.
require('@geodir/geodir-js');
// If you only need e.g. Routing, you can only require the needed parts
//var GeodirRouting = require('@geodir/geodir-js/src/GeodirRouting');
//var GRInput = require('@geodir/geodir-js/src/GRInput');
window.onload = function() {
var defaultKey = "[Sign-up for free and get your own key: https://www.geodir.co/]";
var profile = "car";
var host;
var ghRouting = new GraphHopper.Routing({key: defaultKey, host: host, vehicle: profile, elevation: false});
// If you only need e.g. Routing, you can only require the needed parts
//var ghRouting = new GeodirRouting({key: defaultKey, host: host, vehicle: profile, elevation: false});
// Setup your own Points
ghRouting.addPoint(new GRInput(47.400905, 8.534317));
ghRouting.addPoint(new GRInput(47.394108, 8.538265));
ghRouting.doRequest()
.then(function(json){
// Add your own result handling here
console.log(json);
})
.catch(function(err){
console.error(err.message);
});
};
Running Tests
You can run all tests via npm test
. If you only want to run a single spec file, you can use the --spec
option, e.g., npm test --spec spec/GeodirRoutingSpec.js
.
Dependencies
The API depends on superagent and bluebird which are packaged into the geodir-js.js.
The demo uses a couple of dependencies, but they are not required for requests to the API.
Integrate the APIs in your application
You can either use our bundled version, including all APIs or you can use only the pieces you need.
GraphHopper Routing API
You need the routing client.
There is also a different client developed from the community here.
Geodir Isochrone API
You need the isochrone client
Geodir Geocoding API
You need the geocoding client.