Map Routes API

๐ŸŒŽ Welcome to the OpenTrack Map Routes API

The OpenTrack Map Routes API allows you to consume vessel, rail, and truck routes via API, so you can display beautiful voyage lines on maps in your own application.

As always, contact us if you'd like some help using the Map Routes API in your unique circumstances.

๐Ÿš€ Using the API

๐Ÿ”’ Authentication

If you are already an OpenTrack customer, you can use your existing API key to access the Map Routes API.

Put the API key as a header in your request, with the key OpenTrack-API-Key and the value as your API key. Like this:

--header 'OpenTrack-API-Key: {your-API-key}'

Get a Single Container's Route

Use the endpoint:

https://api.opentrack.co/v1/routes/{containerId}

Here's a sample request:

curl --location 'https://api.opentrack.co/v1/routes/{containerId}' \
     --header 'OpenTrack-API-Key: {your-API-key}'

Replace the {curly-bracketed} values with your own.

Consuming the Response

Here's a sample response body:

{
    "data": {
        "containerId": "OPNT5192841",
        "masterBillId": "MBOL12345678",
        "lastKnownPosition": {
            "type": "Point",
            "coordinates": [
                -74.118213003,
                40.678858019
            ]
        },
        "status": "DISCHARGED",
        "route": [
            {
                "from": {
                    "type": "Feature",
                    "properties": {
                        "name": "Fuzhou",
                        "state": "Fujian",
                        "country": "China",
                        "city": "Fuqing",
                        "timezone": "Asia/Shanghai"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            119.384334,
                            25.721143
                        ]
                    }
                },
                "to": {
                    "type": "Feature",
                    "properties": {
                        "name": "FUQING",
                        "state": "Fujian",
                        "country": "China",
                        "city": "Fuqing",
                        "timezone": "Asia/Shanghai"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            119.384334,
                            25.721143
                        ]
                    }
                },
                "points": {
                    "type": "Feature",
                    "properties": {},
                    "geometry": {
                        "type": "LineString",
                        "coordinates": [
                            [
                                119.384334,
                                25.721143
                            ],
                            [
                                119.384334,
                                25.721143
                            ]
                        ]
                    }
                },
                "modeOfTransport": "TRUCK",
                "segment": "origin",
                "eventClassifierCode": "ACT"
            },
            {
                "from": {
                    "type": "Feature",
                    "properties": {
                        "name": "FUQING",
                        "state": "Fujian",
                        "country": "China",
                        "city": "Fuqing",
                        "timezone": "Asia/Shanghai"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            119.384334,
                            25.721143
                        ]
                    }
                },
                "to": {
                    "type": "Feature",
                    "properties": {
                        "name": "NINGBO",
                        "state": "Zhejiang",
                        "country": "China",
                        "city": "Ningbo",
                        "timezone": "Asia/Shanghai"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            121.54399,
                            29.868336
                        ]
                    }
                },
                "points": {
                    "type": "Feature",
                    "geometry": {
                        "type": "LineString",
                        "coordinates": [
                            [
                                119.384334,
                                25.721143
                            ],
                            [
                                119.6788,
                                26.1071
                            ],
                            [
                                119.7502,
                                26.0995
                            ],
                            [
                                119.8812,
                                26.1711
                            ],
                            [
                                119.9391,
                                26.1832
                            ],
                            [
                                119.9811,
                                26.1809
                            ],
                            [
                                120.2152,
                                26.0753
                            ],
                            [
                                120.6087,
                                26.72
                            ],
                            [
                                120.7729,
                                26.9299
                            ],
                            [
                                120.8543,
                                27.041
                            ],
                            [
                                120.8962,
                                27.1327
                            ],
                            [
                                120.9055,
                                27.3285
                            ],
                            [
                                120.9079,
                                27.4221
                            ],
                            [
                                120.952,
                                27.5067
                            ],
                            [
                                121.09,
                                27.5964
                            ],
                            [
                                121.2074,
                                27.6855
                            ],
                            [
                                121.3,
                                27.8
                            ],
                            [
                                121.5588,
                                28.0024
                            ],
                            [
                                121.717,
                                28.1165
                            ],
                            [
                                121.8488,
                                28.2285
                            ],
                            [
                                121.9542,
                                28.3445
                            ],
                            [
                                122.0775,
                                28.54
                            ],
                            [
                                122.1076,
                                28.6474
                            ],
                            [
                                122.117,
                                28.7556
                            ],
                            [
                                122.1086,
                                28.9682
                            ],
                            [
                                122.3118,
                                29.2611
                            ],
                            [
                                122.4325,
                                29.4986
                            ],
                            [
                                122.64,
                                29.6598
                            ],
                            [
                                122.9236,
                                29.9139
                            ],
                            [
                                122.9038,
                                30.0415
                            ],
                            [
                                122.8685,
                                30.1773
                            ],
                            [
                                122.8246,
                                30.3593
                            ],
                            [
                                122.7598,
                                30.5386
                            ],
                            [
                                122.6076,
                                30.6863
                            ],
                            [
                                122.5278,
                                30.6947
                            ],
                            [
                                122.4721,
                                30.6889
                            ],
                            [
                                122.4345,
                                30.6629
                            ],
                            [
                                122.293,
                                30.6058
                            ],
                            [
                                122.1728,
                                30.5114
                            ],
                            [
                                121.9004,
                                30.5416
                            ],
                            [
                                121.8451,
                                30.3679
                            ],
                            [
                                121.8209,
                                30.2962
                            ],
                            [
                                121.8006,
                                30.1672
                            ],
                            [
                                121.7871,
                                30.103
                            ],
                            [
                                121.7893,
                                30.0485
                            ],
                            [
                                121.8117,
                                29.9844
                            ],
                            [
                                121.54399,
                                29.868336
                            ]
                        ]
                    },
                    "properties": {}
                },
                "segment": "ocean",
                "modeOfTransport": "VESSEL",
                "eventClassifierCode": "ACT"
            },
            {
                "from": {
                    "type": "Feature",
                    "properties": {
                        "name": "NINGBO",
                        "state": "Zhejiang",
                        "country": "China",
                        "city": "Ningbo",
                        "timezone": "Asia/Shanghai"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            121.54399,
                            29.868336
                        ]
                    }
                },
                "to": {
                    "type": "Feature",
                    "properties": {
                        "name": "MANZANILLO",
                        "state": "Provincia de Colรณn",
                        "country": "Panama",
                        "city": "Colรณn",
                        "timezone": "America/Panama"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            -79.8811514,
                            9.3651477
                        ]
                    }
                },
                "points": {
                    "type": "Feature",
                    "geometry": {
                        "type": "MultiLineString",
                        "coordinates": [
                            [
                                [
                                    121.54399,
                                    29.868336
                                ],
                                [
                                    121.8117,
                                    29.9844
                                ],
                                [
                                    121.7893,
                                    30.0485
                                ],
                                [
                                    121.7871,
                                    30.103
                                ],
                                [
                                    121.8006,
                                    30.1672
                                ],
                                [
                                    121.8209,
                                    30.2962
                                ],
                                [
                                    121.8451,
                                    30.3679
                                ],
                                [
                                    121.9004,
                                    30.5416
                                ],
                                [
                                    121.9393,
                                    30.6845
                                ],
                                [
                                    122.0167,
                                    30.7585
                                ],
                                [
                                    122.3133,
                                    30.8815
                                ],
                                [
                                    122.6585,
                                    31.1271
                                ],
                                [
                                    122.9,
                                    31.3
                                ],
                                [
                                    124.7199,
                                    32.4229
                                ],
                                [
                                    125.4431,
                                    32.8858
                                ],
                                [
                                    125.8771,
                                    33.3833
                                ],
                                [
                                    126.5397,
                                    33.5458
                                ],
                                [
                                    126.7634,
                                    33.7596
                                ],
                                [
                                    126.9631,
                                    33.8784
                                ],
                                [
                                    127.118,
                                    34.013
                                ],
                                [
                                    127.2905,
                                    34.1014
                                ],
                                [
                                    127.6,
                                    34.2
                                ],
                                [
                                    128.5633,
                                    34.5185
                                ],
                                [
                                    128.8932,
                                    34.7304
                                ],
                                [
                                    129.2,
                                    35
                                ],
                                [
                                    130.2394,
                                    35.5914
                                ],
                                [
                                    131.2132,
                                    36.1303
                                ],
                                [
                                    131.621,
                                    36.4694
                                ],
                                [
                                    131.9639,
                                    36.6918
                                ],
                                [
                                    132.7945,
                                    37.2804
                                ],
                                [
                                    134.0843,
                                    38.2106
                                ],
                                [
                                    136.7422,
                                    39.7053
                                ],
                                [
                                    139.4,
                                    41.2
                                ],
                                [
                                    140.2974,
                                    41.2897
                                ],
                                [
                                    140.5215,
                                    41.4409
                                ],
                                [
                                    140.8737,
                                    41.5842
                                ],
                                [
                                    141.1998,
                                    41.6345
                                ],
                                [
                                    141.438,
                                    41.6542
                                ],
                                [
                                    141.8092,
                                    41.6607
                                ],
                                [
                                    142.3529,
                                    41.6962
                                ],
                                [
                                    143.0182,
                                    41.7804
                                ],
                                [
                                    143.2549,
                                    41.8358
                                ],
                                [
                                    146.6594,
                                    42.6662
                                ],
                                [
                                    147.9776,
                                    42.8194
                                ],
                                [
                                    152.3255,
                                    44.0244
                                ],
                                [
                                    152.6403,
                                    44.0654
                                ],
                                [
                                    156.4883,
                                    44.567
                                ],
                                [
                                    158.683,
                                    44.853
                                ],
                                [
                                    158.7269,
                                    44.8567
                                ],
                                [
                                    163.6826,
                                    45.2751
                                ],
                                [
                                    167.2257,
                                    45.9536
                                ],
                                [
                                    171.2794,
                                    46.3128
                                ],
                                [
                                    174.2694,
                                    45.7503
                                ],
                                [
                                    175.7246,
                                    45.7246
                                ],
                                [
                                    176.5468,
                                    45.71
                                ],
                                [
                                    177.5405,
                                    45.6924
                                ],
                                [
                                    179.2906,
                                    45.6638
                                ],
                                [
                                    179.7122,
                                    45.6803
                                ],
                                [
                                    180,
                                    45.7016
                                ],
                                [
                                    180,
                                    45.7016
                                ]
                            ],
                            [
                                [
                                    -180,
                                    45.7016
                                ],
                                [
                                    -178.4089,
                                    45.9036
                                ],
                                [
                                    -176.5676,
                                    46.3482
                                ],
                                [
                                    -175.2994,
                                    46.3049
                                ],
                                [
                                    -173.9948,
                                    46.2352
                                ],
                                [
                                    -167.8819,
                                    45.7098
                                ],
                                [
                                    -166.0455,
                                    45.4811
                                ],
                                [
                                    -165.1273,
                                    45.3938
                                ],
                                [
                                    -161.2138,
                                    45.0338
                                ],
                                [
                                    -160.0037,
                                    44.9152
                                ],
                                [
                                    -156.0556,
                                    44.4591
                                ],
                                [
                                    -155.3646,
                                    44.3533
                                ],
                                [
                                    -151.9101,
                                    43.5897
                                ],
                                [
                                    -149.984,
                                    43.1378
                                ],
                                [
                                    -147.7157,
                                    42.572
                                ],
                                [
                                    -145.8447,
                                    42.1017
                                ],
                                [
                                    -140,
                                    40
                                ],
                                [
                                    -135.767,
                                    38.2716
                                ],
                                [
                                    -134.5487,
                                    37.7741
                                ],
                                [
                                    -133.1383,
                                    37.1038
                                ],
                                [
                                    -130.0018,
                                    35.6132
                                ],
                                [
                                    -129.8193,
                                    35.5264
                                ],
                                [
                                    -129.4201,
                                    35.3367
                                ],
                                [
                                    -129.2517,
                                    35.2459
                                ],
                                [
                                    -126.657,
                                    33.8473
                                ],
                                [
                                    -125.7944,
                                    33.3823
                                ],
                                [
                                    -124.5844,
                                    32.7301
                                ],
                                [
                                    -124.3124,
                                    32.5681
                                ],
                                [
                                    -123.5414,
                                    32.109
                                ],
                                [
                                    -120,
                                    30
                                ],
                                [
                                    -118.47,
                                    29.5311
                                ],
                                [
                                    -117.4911,
                                    28.6933
                                ],
                                [
                                    -116.1738,
                                    28.0072
                                ],
                                [
                                    -115.2,
                                    27.5
                                ],
                                [
                                    -113.9866,
                                    26.0802
                                ],
                                [
                                    -112.6539,
                                    24.8329
                                ],
                                [
                                    -109.7,
                                    22.5
                                ],
                                [
                                    -107.2,
                                    20.625
                                ],
                                [
                                    -106.4587,
                                    20.1215
                                ],
                                [
                                    -105.1965,
                                    19.1168
                                ],
                                [
                                    -104.7,
                                    18.75
                                ],
                                [
                                    -104.2966,
                                    18.5071
                                ],
                                [
                                    -103.0702,
                                    17.8643
                                ],
                                [
                                    -102.6672,
                                    17.6557
                                ],
                                [
                                    -99.9134,
                                    15.6306
                                ],
                                [
                                    -99.644,
                                    15.5163
                                ],
                                [
                                    -93.9243,
                                    12.9057
                                ],
                                [
                                    -90.9913,
                                    11.4888
                                ],
                                [
                                    -89.1108,
                                    10.5804
                                ],
                                [
                                    -88.3178,
                                    10.1973
                                ],
                                [
                                    -87.9974,
                                    10.0358
                                ],
                                [
                                    -82.8,
                                    7.4167
                                ],
                                [
                                    -82.0819,
                                    7.3481
                                ],
                                [
                                    -81.8611,
                                    7.1342
                                ],
                                [
                                    -81.1121,
                                    7.0362
                                ],
                                [
                                    -79.9569,
                                    7.1378
                                ],
                                [
                                    -79.9547,
                                    7.1449
                                ],
                                [
                                    -79.5,
                                    8.6
                                ],
                                [
                                    -79.537,
                                    8.9
                                ],
                                [
                                    -79.5677,
                                    8.947
                                ],
                                [
                                    -79.5771,
                                    8.9694
                                ],
                                [
                                    -79.5816,
                                    8.9841
                                ],
                                [
                                    -79.5864,
                                    8.9917
                                ],
                                [
                                    -79.5983,
                                    9.0035
                                ],
                                [
                                    -79.6085,
                                    9.0138
                                ],
                                [
                                    -79.6176,
                                    9.0215
                                ],
                                [
                                    -79.6258,
                                    9.0251
                                ],
                                [
                                    -79.6438,
                                    9.0382
                                ],
                                [
                                    -79.6578,
                                    9.0568
                                ],
                                [
                                    -79.6712,
                                    9.0682
                                ],
                                [
                                    -79.6788,
                                    9.0851
                                ],
                                [
                                    -79.687,
                                    9.1
                                ],
                                [
                                    -79.6905,
                                    9.1063
                                ],
                                [
                                    -79.6956,
                                    9.1106
                                ],
                                [
                                    -79.7097,
                                    9.116
                                ],
                                [
                                    -79.7396,
                                    9.1197
                                ],
                                [
                                    -79.747,
                                    9.1217
                                ],
                                [
                                    -79.7555,
                                    9.1206
                                ],
                                [
                                    -79.7651,
                                    9.113
                                ],
                                [
                                    -79.7748,
                                    9.113
                                ],
                                [
                                    -79.8032,
                                    9.1208
                                ],
                                [
                                    -79.8093,
                                    9.1306
                                ],
                                [
                                    -79.8106,
                                    9.1503
                                ],
                                [
                                    -79.8159,
                                    9.1675
                                ],
                                [
                                    -79.8326,
                                    9.1764
                                ],
                                [
                                    -79.8445,
                                    9.1835
                                ],
                                [
                                    -79.863,
                                    9.1829
                                ],
                                [
                                    -79.8789,
                                    9.1868
                                ],
                                [
                                    -79.9218,
                                    9.206
                                ],
                                [
                                    -79.932,
                                    9.2212
                                ],
                                [
                                    -79.9269,
                                    9.236
                                ],
                                [
                                    -79.917,
                                    9.25
                                ],
                                [
                                    -79.9111,
                                    9.2625
                                ],
                                [
                                    -79.9186,
                                    9.312
                                ],
                                [
                                    -79.9178,
                                    9.3392
                                ],
                                [
                                    -79.9162,
                                    9.3511
                                ],
                                [
                                    -79.9159,
                                    9.3599
                                ],
                                [
                                    -79.9116,
                                    9.3697
                                ],
                                [
                                    -79.9054,
                                    9.3736
                                ],
                                [
                                    -79.8947,
                                    9.3736
                                ],
                                [
                                    -79.8908,
                                    9.3679
                                ],
                                [
                                    -79.8877,
                                    9.3581
                                ],
                                [
                                    -79.8811514,
                                    9.3651477
                                ]
                            ]
                        ]
                    },
                    "properties": {}
                },
                "segment": "ocean",
                "modeOfTransport": "VESSEL",
                "eventClassifierCode": "ACT"
            },
            {
                "from": {
                    "type": "Feature",
                    "properties": {
                        "name": "MANZANILLO",
                        "state": "Provincia de Colรณn",
                        "country": "Panama",
                        "city": "Colรณn",
                        "timezone": "America/Panama"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            -79.8811514,
                            9.3651477
                        ]
                    }
                },
                "to": {
                    "type": "Feature",
                    "properties": {
                        "name": "NEW YORK, NY",
                        "state": "New York",
                        "country": "United States",
                        "city": "New York",
                        "timezone": "America/New_York"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            -74.11821300252025,
                            40.67885801870869
                        ]
                    }
                },
                "points": {
                    "type": "Feature",
                    "geometry": {
                        "type": "LineString",
                        "coordinates": [
                            [
                                -79.8811514,
                                9.3651477
                            ],
                            [
                                -79.8877,
                                9.3581
                            ],
                            [
                                -79.8908,
                                9.3679
                            ],
                            [
                                -79.8947,
                                9.3736
                            ],
                            [
                                -79.9054,
                                9.3736
                            ],
                            [
                                -79.9116,
                                9.3697
                            ],
                            [
                                -79.9248,
                                9.374
                            ],
                            [
                                -79.9191,
                                9.3912
                            ],
                            [
                                -79.9677,
                                9.575
                            ],
                            [
                                -80,
                                9.75
                            ],
                            [
                                -79.5333,
                                10.5578
                            ],
                            [
                                -77.5601,
                                13.9736
                            ],
                            [
                                -76.5916,
                                15.7574
                            ],
                            [
                                -75.6241,
                                16.8778
                            ],
                            [
                                -75.2886,
                                17.7497
                            ],
                            [
                                -75.2287,
                                18.2004
                            ],
                            [
                                -75.107,
                                18.4157
                            ],
                            [
                                -75,
                                18.5
                            ],
                            [
                                -74.5972,
                                19.0589
                            ],
                            [
                                -74.1869,
                                19.9296
                            ],
                            [
                                -74.1476,
                                19.9936
                            ],
                            [
                                -74.0771,
                                20.1208
                            ],
                            [
                                -74.0542,
                                20.2479
                            ],
                            [
                                -74.1686,
                                20.4911
                            ],
                            [
                                -75.2,
                                21.5
                            ],
                            [
                                -75.3494,
                                21.9607
                            ],
                            [
                                -75.6456,
                                22.4776
                            ],
                            [
                                -75.9444,
                                22.71
                            ],
                            [
                                -76.28,
                                23.024
                            ],
                            [
                                -76.9402,
                                23.8335
                            ],
                            [
                                -77.289,
                                24.4872
                            ],
                            [
                                -77.7037,
                                25.0387
                            ],
                            [
                                -77.7387,
                                25.1286
                            ],
                            [
                                -77.7468,
                                25.1935
                            ],
                            [
                                -77.7261,
                                25.2615
                            ],
                            [
                                -77.666,
                                25.3743
                            ],
                            [
                                -77.4572,
                                25.5363
                            ],
                            [
                                -77.2883,
                                25.7105
                            ],
                            [
                                -77.1065,
                                25.8588
                            ],
                            [
                                -76.9708,
                                26.0228
                            ],
                            [
                                -76.865,
                                26.2227
                            ],
                            [
                                -76.6707,
                                26.8634
                            ],
                            [
                                -76.6373,
                                27.0161
                            ],
                            [
                                -76.5877,
                                27.3971
                            ],
                            [
                                -76.5676,
                                27.4568
                            ],
                            [
                                -76.0892,
                                28.8753
                            ],
                            [
                                -75.6027,
                                30.3179
                            ],
                            [
                                -75.3432,
                                30.6901
                            ],
                            [
                                -75.2853,
                                31.2592
                            ],
                            [
                                -75.7747,
                                32.738
                            ],
                            [
                                -74.779,
                                33.7188
                            ],
                            [
                                -75.0918,
                                34.5073
                            ],
                            [
                                -75.0918,
                                34.7808
                            ],
                            [
                                -75.1081,
                                35.2318
                            ],
                            [
                                -75.1,
                                35.6
                            ],
                            [
                                -75.0737,
                                35.8144
                            ],
                            [
                                -74.838,
                                36.3654
                            ],
                            [
                                -74.6999,
                                36.7128
                            ],
                            [
                                -74.6333,
                                36.8695
                            ],
                            [
                                -74.493,
                                37.3115
                            ],
                            [
                                -74.3527,
                                37.7824
                            ],
                            [
                                -74.2126,
                                38.1534
                            ],
                            [
                                -74.0873,
                                38.4697
                            ],
                            [
                                -73.9126,
                                38.9834
                            ],
                            [
                                -73.7521,
                                39.4215
                            ],
                            [
                                -73.7709,
                                39.759
                            ],
                            [
                                -73.783,
                                40.0331
                            ],
                            [
                                -73.7848,
                                40.0884
                            ],
                            [
                                -73.7932,
                                40.3456
                            ],
                            [
                                -73.8129,
                                40.4456
                            ],
                            [
                                -73.8929,
                                40.4799
                            ],
                            [
                                -73.9393,
                                40.498
                            ],
                            [
                                -74.0106,
                                40.5253
                            ],
                            [
                                -74.0226,
                                40.5373
                            ],
                            [
                                -74.031,
                                40.564
                            ],
                            [
                                -74.0396,
                                40.5937
                            ],
                            [
                                -74.0456,
                                40.6061
                            ],
                            [
                                -74.0494,
                                40.6143
                            ],
                            [
                                -74.0673,
                                40.649
                            ],
                            [
                                -74.0793,
                                40.6526
                            ],
                            [
                                -74.0924,
                                40.6483
                            ],
                            [
                                -74.1057,
                                40.6479
                            ],
                            [
                                -74.1236,
                                40.644
                            ],
                            [
                                -74.1398,
                                40.6425
                            ],
                            [
                                -74.1518,
                                40.6431
                            ],
                            [
                                -74.1382,
                                40.6614
                            ],
                            [
                                -74.1271,
                                40.6769
                            ],
                            [
                                -74.11821300252025,
                                40.67885801870869
                            ]
                        ]
                    },
                    "properties": {}
                },
                "segment": "ocean",
                "modeOfTransport": "VESSEL",
                "eventClassifierCode": "ACT"
            },
            {
                "from": {
                    "type": "Feature",
                    "properties": {
                        "name": "NEW YORK, NY",
                        "state": "New York",
                        "country": "United States",
                        "city": "New York",
                        "timezone": "America/New_York"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            -74.11821300252025,
                            40.67885801870869
                        ]
                    }
                },
                "to": {
                    "type": "Feature",
                    "properties": {
                        "name": "OPNT5192841",
                        "status": "DISCHARGED"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            -74.118213003,
                            40.678858019
                        ]
                    }
                },
                "points": {
                    "type": "Feature",
                    "geometry": {
                        "type": "LineString",
                        "coordinates": [
                            [
                                -74.11821300252025,
                                40.67885801870869
                            ],
                            [
                                -74.09779,
                                40.6829
                            ],
                            [
                                -74.118213003,
                                40.678858019
                            ]
                        ]
                    },
                    "properties": {}
                },
                "modeOfTransport": "RAIL",
                "segment": "destination",
                "eventClassifierCode": "ACT"
            },
            {
                "from": {
                    "type": "Feature",
                    "properties": {
                        "name": "OPNT5192841",
                        "status": "DISCHARGED"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            -74.118213003,
                            40.678858019
                        ]
                    }
                },
                "to": {
                    "type": "Feature",
                    "properties": {
                        "name": "Kansas City",
                        "state": "Kansas",
                        "country": "United States",
                        "city": "Kansas City",
                        "timezone": "America/Chicago"
                    },
                    "geometry": {
                        "type": "Point",
                        "coordinates": [
                            -94.62678729999999,
                            39.11553139999999
                        ]
                    }
                },
                "points": {
                    "type": "Feature",
                    "geometry": {
                        "type": "LineString",
                        "coordinates": [
                            [
                                -74.118213003,
                                40.678858019
                            ],
                            [
                                -74.09779,
                                40.6829
                            ],
                            [
                                -74.09709,
                                40.68825
                            ],
                            [
                                -74.09938,
                                40.68949
                            ],
                            [
                                -74.12296,
                                40.70073
                            ],
                            [
                                -74.14889,
                                40.70689
                            ],
                            [
                                -74.15567,
                                40.7085
                            ],
                            [
                                -74.16994,
                                40.71188
                            ],
                            [
                                -74.17774,
                                40.71374
                            ],
                            [
                                -74.17908,
                                40.71405
                            ],
                            [
                                -74.1815,
                                40.71356
                            ],
                            [
                                -74.18503,
                                40.71283
                            ],
                            [
                                -74.18576,
                                40.71268
                            ],
                            [
                                -74.19572,
                                40.70916
                            ],
                            [
                                -74.21384,
                                40.6984
                            ],
                            [
                                -74.27918,
                                40.65946
                            ],
                            [
                                -74.52696,
                                40.56114
                            ],
                            [
                                -74.53483,
                                40.55959
                            ],
                            [
                                -74.5363,
                                40.55916
                            ],
                            [
                                -74.57515,
                                40.54791
                            ],
                            [
                                -74.57719,
                                40.54733
                            ],
                            [
                                -74.64328,
                                40.52824
                            ],
                            [
                                -74.76207,
                                40.51189
                            ],
                            [
                                -75.04708,
                                40.66215
                            ],
                            [
                                -75.11927,
                                40.64981
                            ],
                            [
                                -75.19714,
                                40.68659
                            ],
                            [
                                -75.20088,
                                40.68797
                            ],
                            [
                                -75.20988,
                                40.68525
                            ],
                            [
                                -75.35132,
                                40.6188
                            ],
                            [
                                -75.38276,
                                40.61412
                            ],
                            [
                                -75.45425,
                                40.59793
                            ],
                            [
                                -75.46,
                                40.59667
                            ],
                            [
                                -75.60655,
                                40.51129
                            ],
                            [
                                -75.92984,
                                40.40928
                            ],
                            [
                                -75.93274,
                                40.3763
                            ],
                            [
                                -75.95376,
                                40.34626
                            ],
                            [
                                -75.95349,
                                40.33995
                            ],
                            [
                                -75.9627,
                                40.33659
                            ],
                            [
                                -76.28865,
                                40.36532
                            ],
                            [
                                -76.86355,
                                40.25692
                            ],
                            [
                                -76.87936,
                                40.26725
                            ],
                            [
                                -76.88084,
                                40.26969
                            ],
                            [
                                -76.88706,
                                40.27965
                            ],
                            [
                                -76.89371,
                                40.30144
                            ],
                            [
                                -76.91556,
                                40.33188
                            ],
                            [
                                -76.91557,
                                40.33188
                            ],
                            [
                                -76.91565,
                                40.33189
                            ],
                            [
                                -76.91953,
                                40.3323
                            ],
                            [
                                -76.92131,
                                40.33372
                            ],
                            [
                                -76.92602,
                                40.33786
                            ],
                            [
                                -76.92838,
                                40.33993
                            ],
                            [
                                -76.94202,
                                40.35738
                            ],
                            [
                                -76.95037,
                                40.35788
                            ],
                            [
                                -77.01003,
                                40.35825
                            ],
                            [
                                -77.01587,
                                40.36028
                            ],
                            [
                                -77.01519,
                                40.411
                            ],
                            [
                                -77.08182,
                                40.48365
                            ],
                            [
                                -77.09944,
                                40.48753
                            ],
                            [
                                -77.10451,
                                40.48298
                            ],
                            [
                                -77.10617,
                                40.47492
                            ],
                            [
                                -77.19633,
                                40.56056
                            ],
                            [
                                -77.32677,
                                40.52235
                            ],
                            [
                                -77.36172,
                                40.52916
                            ],
                            [
                                -77.40423,
                                40.56316
                            ],
                            [
                                -77.40435,
                                40.57286
                            ],
                            [
                                -77.40815,
                                40.57848
                            ],
                            [
                                -77.49573,
                                40.59702
                            ],
                            [
                                -77.55096,
                                40.57451
                            ],
                            [
                                -77.57296,
                                40.58563
                            ],
                            [
                                -77.59843,
                                40.56102
                            ],
                            [
                                -77.64535,
                                40.54033
                            ],
                            [
                                -77.64646,
                                40.52799
                            ],
                            [
                                -77.70537,
                                40.51493
                            ],
                            [
                                -77.77386,
                                40.43493
                            ],
                            [
                                -77.77832,
                                40.43256
                            ],
                            [
                                -77.78724,
                                40.421
                            ],
                            [
                                -77.81044,
                                40.40553
                            ],
                            [
                                -77.84293,
                                40.39038
                            ],
                            [
                                -77.86852,
                                40.38191
                            ],
                            [
                                -77.90136,
                                40.38914
                            ],
                            [
                                -77.92621,
                                40.39306
                            ],
                            [
                                -77.95758,
                                40.44635
                            ],
                            [
                                -77.96155,
                                40.44833
                            ],
                            [
                                -78.0067,
                                40.48191
                            ],
                            [
                                -78.02398,
                                40.50889
                            ],
                            [
                                -78.02879,
                                40.53869
                            ],
                            [
                                -78.03588,
                                40.5477
                            ],
                            [
                                -78.03512,
                                40.55233
                            ],
                            [
                                -78.04751,
                                40.56698
                            ],
                            [
                                -78.06354,
                                40.56801
                            ],
                            [
                                -78.14935,
                                40.61423
                            ],
                            [
                                -78.16287,
                                40.61289
                            ],
                            [
                                -78.22336,
                                40.66406
                            ],
                            [
                                -78.28515,
                                40.63943
                            ],
                            [
                                -78.32154,
                                40.62425
                            ],
                            [
                                -78.32393,
                                40.61202
                            ],
                            [
                                -78.36252,
                                40.56175
                            ],
                            [
                                -78.37275,
                                40.54823
                            ],
                            [
                                -78.40271,
                                40.51361
                            ],
                            [
                                -78.40293,
                                40.51336
                            ],
                            [
                                -78.40482,
                                40.51231
                            ],
                            [
                                -78.42574,
                                40.50069
                            ],
                            [
                                -78.43232,
                                40.49071
                            ],
                            [
                                -78.47973,
                                40.47537
                            ],
                            [
                                -78.49341,
                                40.47743
                            ],
                            [
                                -78.52532,
                                40.47946
                            ],
                            [
                                -78.52552,
                                40.47945
                            ],
                            [
                                -78.55714,
                                40.47856
                            ],
                            [
                                -78.56183,
                                40.47843
                            ],
                            [
                                -78.57441,
                                40.47807
                            ],
                            [
                                -78.5746,
                                40.47806
                            ],
                            [
                                -78.57472,
                                40.47806
                            ],
                            [
                                -78.63676,
                                40.40762
                            ],
                            [
                                -78.69786,
                                40.39106
                            ],
                            [
                                -78.78279,
                                40.36959
                            ],
                            [
                                -78.80694,
                                40.36974
                            ],
                            [
                                -78.81601,
                                40.3678
                            ],
                            [
                                -78.83753,
                                40.37756
                            ],
                            [
                                -78.84304,
                                40.37717
                            ],
                            [
                                -78.85859,
                                40.36031
                            ],
                            [
                                -78.88969,
                                40.34206
                            ],
                            [
                                -78.88977,
                                40.34201
                            ],
                            [
                                -78.91685,
                                40.32922
                            ],
                            [
                                -78.91764,
                                40.32886
                            ],
                            [
                                -78.92251,
                                40.33046
                            ],
                            [
                                -78.94101,
                                40.36258
                            ],
                            [
                                -78.94104,
                                40.3626
                            ],
                            [
                                -78.96126,
                                40.37351
                            ],
                            [
                                -78.96388,
                                40.3774
                            ],
                            [
                                -78.9725,
                                40.39022
                            ],
                            [
                                -78.975,
                                40.39326
                            ],
                            [
                                -79.00964,
                                40.41482
                            ],
                            [
                                -79.01761,
                                40.41549
                            ],
                            [
                                -79.03086,
                                40.39986
                            ],
                            [
                                -79.05967,
                                40.38816
                            ],
                            [
                                -79.05998,
                                40.38803
                            ],
                            [
                                -79.06004,
                                40.38801
                            ],
                            [
                                -79.07862,
                                40.38046
                            ],
                            [
                                -79.10485,
                                40.3753
                            ],
                            [
                                -79.10513,
                                40.37525
                            ],
                            [
                                -79.1093,
                                40.37454
                            ],
                            [
                                -79.11274,
                                40.37395
                            ],
                            [
                                -79.12105,
                                40.37705
                            ],
                            [
                                -79.20855,
                                40.40967
                            ],
                            [
                                -79.23323,
                                40.40465
                            ],
                            [
                                -79.24005,
                                40.39799
                            ],
                            [
                                -79.28636,
                                40.34634
                            ],
                            [
                                -79.36175,
                                40.32577
                            ],
                            [
                                -79.36386,
                                40.32542
                            ],
                            [
                                -79.38434,
                                40.31854
                            ],
                            [
                                -79.39025,
                                40.31409
                            ],
                            [
                                -79.39071,
                                40.3139
                            ],
                            [
                                -79.39782,
                                40.30879
                            ],
                            [
                                -79.5438,
                                40.30544
                            ],
                            [
                                -79.55543,
                                40.30479
                            ],
                            [
                                -79.68805,
                                40.33194
                            ],
                            [
                                -79.73256,
                                40.35055
                            ],
                            [
                                -79.76456,
                                40.37807
                            ],
                            [
                                -79.82243,
                                40.39659
                            ],
                            [
                                -79.84897,
                                40.3891
                            ],
                            [
                                -79.84966,
                                40.38849
                            ],
                            [
                                -79.85158,
                                40.38941
                            ],
                            [
                                -79.85184,
                                40.3896
                            ],
                            [
                                -79.86749,
                                40.39708
                            ],
                            [
                                -79.87697,
                                40.40604
                            ],
                            [
                                -79.87967,
                                40.40852
                            ],
                            [
                                -79.88298,
                                40.41156
                            ],
                            [
                                -80.04725,
                                40.45973
                            ],
                            [
                                -80.05647,
                                40.4693
                            ],
                            [
                                -80.08037,
                                40.49043
                            ],
                            [
                                -80.23593,
                                40.57878
                            ],
                            [
                                -80.25905,
                                40.67229
                            ],
                            [
                                -80.25959,
                                40.67495
                            ],
                            [
                                -80.29524,
                                40.69587
                            ],
                            [
                                -80.32049,
                                40.74126
                            ],
                            [
                                -80.33053,
                                40.77305
                            ],
                            [
                                -80.33434,
                                40.7871
                            ],
                            [
                                -80.32806,
                                40.81225
                            ],
                            [
                                -80.39839,
                                40.81753
                            ],
                            [
                                -80.412,
                                40.86572
                            ],
                            [
                                -80.45433,
                                40.85498
                            ],
                            [
                                -80.5793,
                                40.83082
                            ],
                            [
                                -80.62053,
                                40.85976
                            ],
                            [
                                -80.62867,
                                40.86632
                            ],
                            [
                                -80.64664,
                                40.87693
                            ],
                            [
                                -80.77328,
                                40.86873
                            ],
                            [
                                -80.85407,
                                40.88973
                            ],
                            [
                                -80.8878,
                                40.91389
                            ],
                            [
                                -81.09361,
                                40.92153
                            ],
                            [
                                -81.09526,
                                40.92191
                            ],
                            [
                                -81.09639,
                                40.92217
                            ],
                            [
                                -81.4168,
                                40.78225
                            ],
                            [
                                -81.7666,
                                40.83988
                            ],
                            [
                                -81.7793,
                                40.83364
                            ],
                            [
                                -81.77982,
                                40.83364
                            ],
                            [
                                -81.9337,
                                40.79729
                            ],
                            [
                                -82.02031,
                                40.68401
                            ],
                            [
                                -82.19997,
                                40.64811
                            ],
                            [
                                -82.51064,
                                40.76568
                            ],
                            [
                                -82.73372,
                                40.78315
                            ],
                            [
                                -82.73932,
                                40.78057
                            ],
                            [
                                -82.78617,
                                40.73033
                            ],
                            [
                                -82.79256,
                                40.7271
                            ],
                            [
                                -82.84879,
                                40.70287
                            ],
                            [
                                -83.03809,
                                40.61539
                            ],
                            [
                                -83.13545,
                                40.59008
                            ],
                            [
                                -83.13638,
                                40.58984
                            ],
                            [
                                -83.14022,
                                40.58968
                            ],
                            [
                                -83.14116,
                                40.58964
                            ],
                            [
                                -83.14535,
                                40.5894
                            ],
                            [
                                -83.3619,
                                40.58464
                            ],
                            [
                                -83.5609,
                                40.52032
                            ],
                            [
                                -83.5633,
                                40.51954
                            ],
                            [
                                -83.56725,
                                40.51825
                            ],
                            [
                                -83.76371,
                                40.35982
                            ],
                            [
                                -84.15568,
                                40.2741
                            ],
                            [
                                -84.15864,
                                40.27404
                            ],
                            [
                                -84.20682,
                                40.273
                            ],
                            [
                                -84.64215,
                                40.21167
                            ],
                            [
                                -84.93762,
                                40.17574
                            ],
                            [
                                -85.38624,
                                40.18834
                            ],
                            [
                                -85.39338,
                                40.18706
                            ],
                            [
                                -85.39571,
                                40.18684
                            ],
                            [
                                -85.39773,
                                40.18646
                            ],
                            [
                                -85.6768,
                                40.25976
                            ],
                            [
                                -85.68043,
                                40.26039
                            ],
                            [
                                -86.03842,
                                40.29034
                            ],
                            [
                                -86.04386,
                                40.29031
                            ],
                            [
                                -86.50451,
                                40.28266
                            ],
                            [
                                -86.51813,
                                40.28256
                            ],
                            [
                                -86.51946,
                                40.28254
                            ],
                            [
                                -86.54535,
                                40.28232
                            ],
                            [
                                -86.87165,
                                40.37742
                            ],
                            [
                                -86.90465,
                                40.39635
                            ],
                            [
                                -86.91392,
                                40.39807
                            ],
                            [
                                -86.92451,
                                40.39321
                            ],
                            [
                                -86.92794,
                                40.39164
                            ],
                            [
                                -86.93227,
                                40.38858
                            ],
                            [
                                -87.42503,
                                40.26935
                            ],
                            [
                                -87.61498,
                                40.14004
                            ],
                            [
                                -87.61681,
                                40.13766
                            ],
                            [
                                -87.6452,
                                40.10035
                            ],
                            [
                                -87.71633,
                                40.05771
                            ],
                            [
                                -88.05721,
                                40.02518
                            ],
                            [
                                -88.05767,
                                40.02513
                            ],
                            [
                                -88.23398,
                                39.99021
                            ],
                            [
                                -88.25939,
                                39.98434
                            ],
                            [
                                -88.26207,
                                39.98372
                            ],
                            [
                                -88.2622,
                                39.98369
                            ],
                            [
                                -88.58433,
                                39.92019
                            ],
                            [
                                -88.8822,
                                39.86251
                            ],
                            [
                                -88.88749,
                                39.86149
                            ],
                            [
                                -88.89804,
                                39.85853
                            ],
                            [
                                -88.93839,
                                39.84851
                            ],
                            [
                                -88.94119,
                                39.84782
                            ],
                            [
                                -88.94309,
                                39.84769
                            ],
                            [
                                -88.9455,
                                39.84765
                            ],
                            [
                                -88.96062,
                                39.84752
                            ],
                            [
                                -89.52735,
                                39.85292
                            ],
                            [
                                -89.60548,
                                39.82414
                            ],
                            [
                                -89.60549,
                                39.82414
                            ],
                            [
                                -89.6296,
                                39.79712
                            ],
                            [
                                -89.65314,
                                39.77075
                            ],
                            [
                                -89.65645,
                                39.76165
                            ],
                            [
                                -89.66257,
                                39.75023
                            ],
                            [
                                -89.67078,
                                39.74917
                            ],
                            [
                                -89.70232,
                                39.7451
                            ],
                            [
                                -90.21972,
                                39.73676
                            ],
                            [
                                -90.2264,
                                39.73769
                            ],
                            [
                                -90.5437,
                                39.75261
                            ],
                            [
                                -90.63696,
                                39.70422
                            ],
                            [
                                -91.36452,
                                39.72269
                            ],
                            [
                                -91.36053,
                                39.71787
                            ],
                            [
                                -91.35902,
                                39.71578
                            ],
                            [
                                -91.83205,
                                39.62896
                            ],
                            [
                                -92.02063,
                                39.47205
                            ],
                            [
                                -92.12407,
                                39.49467
                            ],
                            [
                                -92.4372,
                                39.42169
                            ],
                            [
                                -92.67375,
                                39.43927
                            ],
                            [
                                -92.99284,
                                39.39663
                            ],
                            [
                                -93.15137,
                                39.42795
                            ],
                            [
                                -93.2802,
                                39.33344
                            ],
                            [
                                -93.53617,
                                39.33363
                            ],
                            [
                                -93.53827,
                                39.33318
                            ],
                            [
                                -93.54317,
                                39.33245
                            ],
                            [
                                -93.56173,
                                39.32864
                            ],
                            [
                                -93.80797,
                                39.27765
                            ],
                            [
                                -93.82289,
                                39.27456
                            ],
                            [
                                -93.83349,
                                39.27078
                            ],
                            [
                                -93.83758,
                                39.26916
                            ],
                            [
                                -93.93713,
                                39.22968
                            ],
                            [
                                -93.94051,
                                39.22841
                            ],
                            [
                                -94.03807,
                                39.19172
                            ],
                            [
                                -94.03843,
                                39.19158
                            ],
                            [
                                -94.04057,
                                39.19158
                            ],
                            [
                                -94.04182,
                                39.19158
                            ],
                            [
                                -94.13909,
                                39.19141
                            ],
                            [
                                -94.1834,
                                39.17569
                            ],
                            [
                                -94.31746,
                                39.14714
                            ],
                            [
                                -94.46979,
                                39.11469
                            ],
                            [
                                -94.47444,
                                39.11424
                            ],
                            [
                                -94.48036,
                                39.11367
                            ],
                            [
                                -94.4812,
                                39.11395
                            ],
                            [
                                -94.49904,
                                39.11665
                            ],
                            [
                                -94.49947,
                                39.11684
                            ],
                            [
                                -94.56728,
                                39.11434
                            ],
                            [
                                -94.57975,
                                39.11313
                            ],
                            [
                                -94.58779,
                                39.11116
                            ],
                            [
                                -94.58858,
                                39.1107
                            ],
                            [
                                -94.61451,
                                39.11664
                            ],
                            [
                                -94.61896,
                                39.10985
                            ],
                            [
                                -94.62678729999999,
                                39.11553139999999
                            ]
                        ]
                    },
                    "properties": {}
                },
                "modeOfTransport": "RAIL",
                "segment": "destination",
                "eventClassifierCode": "EST"
            }
        ]
    }
}

๐Ÿšข ๐Ÿš‚ ๐Ÿšš Realistic Vessel, Rail and Truck Routes

The payload's route array is made up of route segments.

Geographic coordinates for the container's full route can be found in the points object.

Each segment's start and end points are in the from and to objects.

๐Ÿ“ Current Position

lastKnownPosition

The container's current position can be found in the lastKnownPosition object. This is the last reported historical position of the container.

This will always be actual (historical), reported to OpenTrack by an AIS data provider or other source.

This position could be anywhere along the container's journey, not just on the ocean.

๐Ÿšข ๐Ÿš‚ ๐Ÿšš Mode of Transport

modeOfTransport

Following the DCSA, the modeOfTransport property provides the transport type for the container on the route provided. This will always be VESSEL for the time being. In the future, we may add support for other route types.

๐Ÿ• Past, present, and future

eventClassifierCode

Also following the DCSA, the eventClassifierCode indicates whether the ocean vessel route provided is estimated (future) or actual (in the past).

  • EST = Estimated. Indicates the future part of the route.
  • ACT = Actual. Indicates the past (historical) part of the route.

Actual historical GPS coordinates from satellite AIS, rail sources, and drayage carriers are used to display the historical routes and current position.

Future routes are estimated using a custom route network that we've built up over the years to follow the most-likely paths of actual vessels and real freight rail lines.

For truck routes, we use Mapbox's directions API.