Targa

This page provides specific information about integrating Targa’s devices into the Astara Connect system through our API services. Soon, this process will be streamlined via the Platform by following the steps to register a tracker.

Connectivity

The vehicles can be connected via CanBus.

Once the vehicle has a device installed and the Targa's confirmation, we can proceed to the registration process inside Astara Connect.

Register and validation process

When you register a vehicle into Astara Connect with Targa as a data provider, the vehicle validation process is usually quick and easy. Start by sending the request to register a vehicle.

This is an example of the body of the request.

{
    "tracker_id"="WF0AXXWPMAJBXXXXX",
    "provider"="targa",
    "type"="canbus",
    "vehicle_type"="car",
    "object_id"={
        "vin": "WF0AXXWPMAJBXXXXX",
        "license_plate": "6666KKK",
        "make": "Hyundai",
        "model": "Ionic"
    }
}

• tracker_id: A unique identifier of the vehicle. For the Targa trackers, the tracker_id will be the vehicle's VIN.
• provider: data provider of the vehicle: targa
• type: indicates the type of connection at the vehicle. In most cases, there will be a CanBus connection: canbus

The validate endpoint could be requested when the endpoint status is pending.

The request body must include the same required information as in the register endpoint:

{
    "tracker_id"="WF0AXXWPMAJBXXXXX",
    "provider"="targa",
    "type"="canbus"
}

Then, upon receiving the first location data from the tracker, the validation status will be updated to connected.

To ingest the first location data, the tracker/vehicle must drive outdoors approximately 500m to send the first coordinates, which will be ingested in Astara Connect.

Connectivity states for a Targa tracker

These are the possible states of the tracker with Targa connection into Astara Connect, and it will be available through the Platform (coming soon) and the API services:

• pending: default state once the register endpoint is completed.
• wrong_tracker_id: wrong VIN number. Check the VIN and modify it if needed. Launch the register request with the right VIN again.
• pending_for_data: We are waiting for the first coordinates from the provider. If the vehicle is in motion and the status has not changed, check the device connection or contact the data provider.
• error_data: no data is received, or telemetry data is incorrect.
• connected: a final state to indicate that we are ingesting data from the data provider into Astara Connect.

⚠️ Targa does not guarantee access via CanBus to all available data because it may be variable depending on the make and model.

You can learn more about the Connectivity states

For any questions, please get in touch with us at [email protected]