NavitiaSDK UX for Cordova

Cordova plugin for using NavitiaSDK UX

Installation

This plugin uses Carthage to build dependencies for iOS, please install it first: https://github.com/Carthage/Carthage

Then use this command to install the plugin

cordova plugin add cordova-plugin-navitia-sdk-ux

Setup for Android platform

This plugin uses Google Maps and requires a Google API key in case you're targeting the Android platform with your cordova application. You can get your own API key using this link: https://developers.google.com/maps/documentation/android-api/signup

You need to update your config.xml file as follows:

<widget ......... xmlns:android="http://schemas.android.com/apk/res/android">
    .
    .
    <platform name="android">
        .
        .
        <config-file parent="/manifest/application" target="AndroidManifest.xml">
            <meta-data android:name="com.google.android.geo.API_KEY" android:value="YOUR_API_KEY" />
        </config-file>
    </platform>
    .
    .
</widget>

Note that you have to change YOUR_API_KEY with your own API key!

Usage

NavitiaSDKUX.init(config, success, failure)

Parameters	Type	Required	Description	Example
config	Object	✓	Configuration
config.token	String	✓	Token navitia	0de19ce5-e0eb-4524-a074-bda3c6894c19
success	Function	✓	Success callback function	function() {}
failure	Function	✓	Failure callback function	function(error) {}

NavitiaSDKUX.invokeJourneyResults(params, success, failure)

Parameters	Type	Required	Description	Example
params	Object	✓	Parameters of the screen
params.originId	String	✓	Origin coordinates, following the format lon;lat	2.3665844;48.8465337
params.destinationId	String	✓	Destination coordinates, following the format lon;lat	2.2979169;48.8848719
params.originLabel	String	✗	Origin label, if not set the address will be displayed	Home
params.destinationLabel	String	✗	Destination label, if not set the address will be displayed	Work
params.datetime	Date	✗	Requested date and time for journey results	new Date()
params.datetimeRepresents	NavitiaSDKUX.DatetimeRepresents	✗	Can be NavitiaSDKUX.DatetimeRepresents.DEPARTURE (journeys after datetime) or NavitiaSDKUX.DatetimeRepresents.ARRIVAL (journeys before datetime).	NavitiaSDKUX.DatetimeRepresents.DEPARTURE
params.forbiddenUris	[String]	✗	List of navitia uris	['commercial_mode:Bus', 'line:1']
params.firstSectionModes	[NavitiaSDKUX.SectionMode]	✗	List of modes to use at the begining of the journey	[NavitiaSDKUX.SectionMode.CAR]
params.lastSectionModes	[NavitiaSDKUX.SectionMode]	✗	List of modes to use at the end of the journey	[NavitiaSDKUX.SectionMode.BIKE, NavitiaSDKUX.SectionMode.BSS]
params.count	Integer	✗	The number of journeys that will be displayed	3
params.minNbJourneys	Integer	✗	The minimum number of journeys that will be displayed	3
params.maxNbJourneys	Integer	✗	The maximum number of journeys that will be displayed	10
success	Function	✓	Success callback function	function() {}
failure	Function	✓	Failure callback function	function(error) {}

Example

var config = {
    token: 'my-token',
};

NavitiaSDKUX.init(config, function() {}, function(error) {
    console.log(error);
});

var journeyParams = {
    originLabel: 'My Home',
    originId: '2.3665844;48.8465337',
    destinationId: '2.2979169;48.8848719',
};

NavitiaSDKUX.invokeJourneyResults(journeyParams, function() {}, function(error) {
    console.log(error);
});

Known issues

• Color configuration not available yet (but soon!)

Troubleshooting

Specific android tools version : 26

In case you are having problems building and getting this kind of problems :

platforms/android/build/intermediates/res/merged/debug/values-v24/values-v24.xml:3: AAPT: Error retrieving parent for item: No resource found that matches the given name ...

You may try to override your android compiler environment variables :

export ORG_GRADLE_PROJECT_cdvCompileSdkVersion=android-26
export ORG_GRADLE_PROJECT_cdvBuildToolsVersion=26.0.1

More information on Cordova website

Manifest merger issue

This usually happens if you change the API key in the config.xml file. The build fails and you're getting this kind of error:

Element meta-data#com.google.android.geo.API_KEY at AndroidManifest.xml:xx:xx-xx duplicated with element declared at AndroidManifest.xml:xx:xx-xx

You may try to remove the Android platform and add it back again.