API Name: routing-api

Introduction

The AfriGIS Routing API allows users to plan routes based on the AfriGIS streets dataset. Options include:

• Routing information ideal for creating a table with turn-by-turn driving instructions
• Route making use of one or more available public transport services, also referred to as multimodal routing
• Routing that returns necessary information to support an interactive navigation solution
• Results that provide spatial features in relation to a specified section of a layer

The API returns the planned route information in either XML or JSON format, which is easily consumed and transformed into printed directions reports or displayed on a map.

Route

Using the GetRouteAG endpoint in the API, users can specify where they will be traveling from (origin) and where they will be going (destination). Additional stops or destinations can be added as via points.

Routing can be optimised by selecting the route by travel time, distance or walking.

Restrictions can be added to avoid toll roads, highways, main roads or streets.

Buffer

By using the buffer functionality, users can answer questions like which toll booths will be encountered along a specific driving route. The endpoint allows users to select a reference feature layer, specify the relevant area or section, and to identify features in another layer that fall within that area or section.

Multimodal route

Multimodal routing means using multiple modes of transport to reach a destination.

AfriGIS multimodal routing makes use of available public transport options to provide the most efficient combination of transport vehicles to reach a destination in the fastest time.

Users can specify to avoid using buses or subways. Optimisation allows users to specify that walking should be minimised, number of transfers limited and options for wheelchair support should be considered.

A planned journey start date and time must be specified.

Navigation route

Navigation route returns the necessary information to support an interactive navigation solution, including coordinates for drawing the route on a map or navigation screen, street level details such as name, travel time and traffic status, voice guided or visual navigation commands, and the optimal order of via points.

Several via points on a route can be added and by enabling a setting, these points can be ordered in the most optimal order to allow efficient routing.

Results are given in different sets of objects, including the route points, feature lists and command list.

Authentication

This API makes use of OAuth2 authentication. To integrate, sign up for a free trial account by contacting [email protected]

For detailed integration instructions using OAuth2, please click on the following link: https://developers.afrigis.co.za/oauth2-authentication/