Route Matching

Please note Sygic does no longer issue new Sygic Maps API keys. This documentation is for existing customers only. If you wish to include maps & navigation into your project, please refer to Sygic Maps SDK.

Overview

Sygic route matching function is a cloud-based service that matches a set of GPS coordinates to a real road and provides the route calculation for given route.
Route is returned in JSON as Google Encoded Polyline.

Example

Request

API Reference

https://routing.api.sygic.com/v0/api/matching

Default output format is JSON and there is no need to specify it anywhere in the URL request.

Methods

Method Description
GET Both methods provide the same functionality.
POST Both methods provide the same functionality.

Parameters

Required Parameters

Parameter Data type Description
path string Google encoded polyline for GPS coordinates for map matching.
key string The API key.

Optional Parameters

Parameter Data type Description
waypoint_indexes string Comma separated list of waypoint indexes from the path.

Response

GET

GET https://routing.api.sygic.com/v0/api/matching?path=gjn~FrhdvOz~AvIbjBlc@v{BzcBdbCzqHrhAl{B&key=yourAPIkey

POST

POST https://routing.api.sygic.com/v0/api/matching

Content-Type: application/json

Request Body

{
    "path": "gjn~FrhdvOz~AvIbjBlc@v{BzcBdbCzqHrhAl{B",
    "key": "yourAPIkey"
}

Reponse Body

Both GET and POST method produce the same response body:

{
    "route": "ein~FrhdvO?aC~ACzAE|AAxACxAA|@A\\?`@?|@AJ?lA@vA?xA?FdNzAAxAChA?N?zA?xACN?hAAtDGj@CfAAbA?jAAfBA|AEpAALnB?vDlAAhBEjAo@`AhDNz@BXl@?T?tEQzDGzBCp@A\\?t@A`@?jCE|AAp@?`@AR?z@AjAC~@MTE~@QlAQ`Dc@HCfEYF?VA^?F?rAAx@?l@@t@JTHZH\\LTFPFLBLDKZ[Fb@xBb@vBxEEAyBAgCzBAZ?`@Ax@Ap@?PAp@?BfC@rB@bB?f@?r@?L@d@@fABhDvJKvA?BtB@rBvAAzDEtDCnBCfAAnB?zAAtAAh@AHNTd@h@bAZj@tBxD~A|CZl@j@fAbAlBdAtBZh@j@hAvBCV?zDEJAF?rDGFxBBvB@zBlJK?~B?vBA|BhBC~FGpJG@tB@vBA|B@rBdJIBzBBxB?zB@vBlGI|AA@dA@hA@bBr@Ar@AvCA~EGv@?n@?hAC\\Af@?n@AfACfAAT?r@A^?hIIt@Al@A?J@tB?tA?ZBtFBtFBvFBtF@lF@dD?z@@|@@pD?N?LDnF@xFB|BBtB?xB?tBrAAzGE@xB@zB?xB?xBnJKlJK?xB?xB@rB?pB_BB_B@gA@{A?cBDoDBg@@S??d@hFIFxMJhFJxFnB?ApB?zBAxBAxBpIAtGGzAC@tF@`A?zA@tA?nA?hA?xABtFB|F?R@rE?d@?zA?b@?|@@l@It@?`@AjCT?tB?dA@Z?r@Ad@SZYd@Wj@EfA@HnALRNXwAi@[MY?UJ_@p@@nA?r@?b@?f@pIMrEGhMQb@?ZAJAf@?`@AX?|@@z@?^@~@PPFx@b@lChBn@X~@P`C@xJKpBCt@ChDCB~E?l@DjCFP@b@BvFDnFBrFBrFBpFBbD@lABpF@p@BbEBtFBjFFbNAfE?b@?lABhDBnC@dBBrFBpFDtFvACjAA`@?nAAzAAvACrAALfNF|I@hCtACl@Af@AF~EBfGHnNNA~HMImH",
    "eta": 1531983706,
    "duration": {
        "value": 2823,
        "text": "47 minutes 3 seconds"
    },
    "distance": {
        "value": 18547,
        "text": "18.55 km"
    },
    "legs": [
        {
            "distance": {
                "value": 18547,
                "text": "18.55 km"
            },
            "duration": {
                "value": 2823,
                "text": "47 minutes 3 seconds"
            },
            "start_location": {
                "latitude": 41.85763,
                "longitude": -87.68154
            },
            "end_location": {
                "latitude": 41.77255,
                "longitude": -87.77467
            },
            "route": "ein~FrhdvO?aC~ACzAE|AAxACxAA|@A\\?`@?|@AJ?lA@vA?xA?FdNzAAxAChA?N?zA?xACN?hAAtDGj@CfAAbA?jAAfBA|AEpAALnB?vDlAAhBEjAo@`AhDNz@BXl@?T?tEQzDGzBCp@A\\?t@A`@?jCE|AAp@?`@AR?z@AjAC~@MTE~@QlAQ`Dc@HCfEYF?VA^?F?rAAx@?l@@t@JTHZH\\LTFPFLBLDKZ[Fb@xBb@vBxEEAyBAgCzBAZ?`@Ax@Ap@?PAp@?BfC@rB@bB?f@?r@?L@d@@fABhDvJKvA?BtB@rBvAAzDEtDCnBCfAAnB?zAAtAAh@AHNTd@h@bAZj@tBxD~A|CZl@j@fAbAlBdAtBZh@j@hAvBCV?zDEJAF?rDGFxBBvB@zBlJK?~B?vBA|BhBC~FGpJG@tB@vBA|B@rBdJIBzBBxB?zB@vBlGI|AA@dA@hA@bBr@Ar@AvCA~EGv@?n@?hAC\\Af@?n@AfACfAAT?r@A^?hIIt@Al@A?J@tB?tA?ZBtFBtFBvFBtF@lF@dD?z@@|@@pD?N?LDnF@xFB|BBtB?xB?tBrAAzGE@xB@zB?xB?xBnJKlJK?xB?xB@rB?pB_BB_B@gA@{A?cBDoDBg@@S??d@hFIFxMJhFJxFnB?ApB?zBAxBAxBpIAtGGzAC@tF@`A?zA@tA?nA?hA?xABtFB|F?R@rE?d@?zA?b@?|@@l@It@?`@AjCT?tB?dA@Z?r@Ad@SZYd@Wj@EfA@HnALRNXwAi@[MY?UJ_@p@@nA?r@?b@?f@pIMrEGhMQb@?ZAJAf@?`@AX?|@@z@?^@~@PPFx@b@lChBn@X~@P`C@xJKpBCt@ChDCB~E?l@DjCFP@b@BvFDnFBrFBrFBpFBbD@lABpF@p@BbEBtFBjFFbNAfE?b@?lABhDBnC@dBBrFBpFDtFvACjAA`@?nAAzAAvACrAALfNF|I@hCtACl@Af@AF~EBfGHnNNA~HMImH"
        }
    ],
    "status": "OK",
    "copyright": "© 2018 Sygic a.s."
}