Iso4App
Isochrones - Isodistances

Isolines for Geographic Network Analysis

Iso4App API


The Iso4App API is a service of the K-SOL S.r.l. based onto OSM data; it's purpose is to provide isolines (isodistances and isochrones) to be used in geographic analysis. We provide our technology as software as a service; you can use our javascript library or rest api in your project. In case you need help please don't hesitate to contact us at .


Features

Generate isolines polygons which represent the area which is reachable from a given source point starting from time or distance

You can use isolines with your preferred maps api

Support for walk, car, bike isolines

Predefined toolbar control

Predefined speed levels and customizable speed value

Flags to reduce queue time and avoid tolls

Get isolines coordinates in seconds

Filled isolines with thematic map. The available categories are: Accomodation, Amenity, Education, Food, Health, Bank/Exchange, Shop, Sport, Tourism, Transport and Italian Population.

If you are interested in having thematics maps with your data please contact us.

Definitions and
implemented countries

Isodistances

Isodistance is a polyline of equal distance from a given point.
With Iso4App you can draw up to 500 kilometres isodistances.

Isochrones

An isochrone is defined as a line drawn on a map connecting points at which something occurs or arrives at the same time. In transportation planning isochrone maps are commonly used to depict areas of equal travel time.
With Iso4App you can draw up to 5 hours isochrones.

Implemented countries

Europe,Russian Federation (European part), China, North America, Central America, South America, Australia-Oceania. If your country is not covered by iso4app and you are interested in using our API, please contact us.

Getting started


The Iso4App JavaScript API is a JavaScript library designed for mobile-friendly geographics maps. Its purpose is to provide you with the wgs84 coordinates of your preferred isoline. You can use iso4app library to draw your isoline using your preferred maps api.
Since this API makes requests to the Iso4App Webservice you need to contact us to get your API key. The API key has a limited number of credits and you can use it for development purposes only. If you like the service you can purchase more credits. Is available also a rest api click here for more information.

Lets draw a 10km isodistance

This basic example shows you how to draw a 10km isodistance starting from a given location using Lefalet.

First we need to import all the mandatory javascript and css files.

    <!--  Leaflet -->
    <link rel="stylesheet" href="http://cdn.leafletjs.com/leaflet/v0.7.7/leaflet.css"/>
    <script src="http://cdn.leafletjs.com/leaflet/v0.7.7/leaflet.js"></script>

    <!-- Iso4App library with a demo key -->
    <script src="http://iso4app.com/api/js?v=1.2&lkey=87B7FB96-83DA-4FBD-A312-7822B96BB143"></script>
	

You should see:

isodistance

If you want to play around with the Iso4App API and see all the features in action, we have built a demo app for you to try out everything.


Some use cases

You can study the reachability in time or distance from a given starting point.

In the example the pedestrian reachability from the center of Rome at intervals of 2 minutes.

Within your isoline you can represent a statistical indicator.
Suppose you have to open a new store and that you have the demographic data of your region.
You can represent your demographics within your isoline.

In the example a thematic map within an isodistance starting from the Italian ISTAT demographic data of the last census.

Suppose you want to know the gas stations that you can reach by car in less than 3 minutes.

If you have the POI database you can use our isolines to provide this type of service to your users.

You can use Iso4App also on ArcGis Online platform. Below you can download the Iso4App widget that you can include in your ArcGis application.



Tutorials


In this section you will find the basic usage of the Iso4App JavaScript API. For more detailed information about the services, information on the utility classes, please have a look at the API section.

API


This sections represents the reference about the iso4app engine offered by the Iso4App JavaScript and Rest API. We discuss all the mandatory and optional parameters and the constants you can use during invocation.

Frequently asked questions


1.How many isolines can be requested using the demo page?

There is not a fixed limit, however this page is only for demo and test purpose, so we can stop users that are requiring too much isolines.

2. How many isolines can be requested using the free personal API Key?

The free personal API Key expires in one month and you have 1000 credits. Paying a fee you can upgrade your personal API Key.

3. How can I check the number of remain credits?

You can login on iso4app using your registration data.

4. I wish to get a travel time map for a truck that cannot go over 80 kmh, how can I do ?

Yon can use the following parameters: set the Travel type to Motor vehicle, the Speed limit to 80 and the Speed type to low or very low.

5. I wish to get a travel time map for an e-bike, how can I do ?

Yon can use the following parameters: set the Travel type to Bicycle, the Speed limit between 25 and 40, the Speed type to Fast and check Reduce queue time.

6. I wish to get a travel time map for a marathon runner, how can I do ?

Yon can use the following parameters: set the Travel type to Pedestrian, the Speed limit between 10 and 20, the Speed type to Fast and check Reduce queue time.

7. I wish to get a travel time map for a moped, how can I do ?

Yon can use the following parameters: set the Travel type to Motor vehicle, the Speed limit between 30 and 45, the Speed type to Fast and check Reduce queue time.

8. I wish to get a travel time map for my car at speed 200 kmh, how can I do ?

You cannot have this travel time map. When you set the Speed limit parameter the system use it to reduce the permitted road speed limit. You cannot increase the permitted road speed limit.

9. I wish to get a travel time map for an elderly person who goes on foot, how can I do ?

Yon can use the following parameters: set the Travel type to Pedestrian and the Speed type to Low or Very Low otherwise you can use the Speed type to Fast and set the speed as you wish using the parameter Speed limit.

10. About the travel time map, how does work the parameter Speed type when tha value is Fast ?

The Fast value work as follow: for Motor vehicle you can travel at the maximum speed permitted for the road; for Bicycle you travel at the 40 kmh speed;for Pedestrian you travel at the 20 kmh speed. For Bicycle or Pedestrian we suggest to reduce the speed setting the parameter Speed limit.

11. Using the demo page I have to use prefixed distances value (i.e. 20 km, 25km); it is possible to use a custom value i.e. 22km ?

Yes you can use a custom value for Isodistances and Travel Time Map (Isochrones) using directly our API by your APP.

Term Of Use


END USER - DATA LICENSE AGREEMENT

IMPORTANT NOTICE: PLEASE READ CAREFULLY BEFORE USING THE DATA SERVICES

This end user service license agreement ("Services license agreement") is a legal agreement between you (the "End User" or "You") and K-SOL S.r.l. The terms of this services license agreement are intended to govern the use of our isolines services (Iso4App).

If you do not agree to all the terms of this services license agreement, we are unwilling to provide you with the services and you must not use our services and you will have no right to access or use our services. If for any reason you have already used our services and you have stored isolines data and no longer agree to all the terms of this data license agreement you must remove all the data you have stored.

License Rights

In exchange for a fee, you can use Iso4App services for a period of time and for a number of requests. You can use Iso4App service free of charge only for test purpose and with the limits below.

1. Freemium without registration: you can ask for 10km isodistances and 10 minutes isochrones.

2. Freemium with registration: you can ask for every type of isolines. Your API key is limited in credits and time.

General Restrictions Iso4App Service

A. You must not pre-fetch, cache or store any content, except that you may store a limited amounts of content for the purpose of improving the performance of your application

    1. You are not allowed to pre-fetch

    2. Data conservation has to be temporary

    3. Data has to be kept in small amounts

B. Substitute service. You must not attempt to create a substitute or similar service through the use of or an access to the iso4app service. You cannot publish a general service layer to show isolines on other applications. Our service must be used on a specific end-user application.

Privacy

We may collect informations such as, but not limited to, an end user's ip address, requests, time of submissions and the results returned to the user, in connection with transaction requests to the services.

Disclaimers

Subscriber uses the services at subscriver's sole risk. The services and content are provided on "as is" and "as available" basis. Unless otherwise explicitly stated, the services or content on the iso4app web site is not intended for use in any mission critical applications. Iso4app disclaims all implied conditions, representations, and warranties of any kind, including any implied warranty of merchantability, fitness for a particular purpose, or noninfringment. Iso4app makes no representation, warranty, or guaranty as to the quality, suitability, truth, accuracy, or completeness of any of the services or content contained on their web sites.

The services and content have been developed from sources believed to be reliable, but their accuracy and completeness are not guaranteed. the services and content may contain nonconformities, defects, inaccuracies, errors, or omissions. Iso4app makes no warranty that:

A. the services will meet subscriber's requirements;

B. the services will be uninterrupted, timely, secure or error free;

C. the results that may be obtained from the use of the services will be accurate or reliable;

D. the quality of any services, data or information obtained by subscriber through the services will meet subsrciber's expectations;

E. any errors in the services, software, data, or information will be corrected.

Attribution

Contains information from Geofabrik Openstreetmap, which is made available here under the Open Database License (ODBL).