Skip to content

quick start

Jump to bottom
TheBoomerDev edited this page May 28, 2026 · 1 revision

Getting Started with transcend-sdk

Welcome! This guide will help you make your first API call in 5 minutes.

Prerequisites

Step 1: Install

pip install transcend-sdk

Step 2: Get Your API Key

  1. Go to https://transcend.cargoffer.com
  2. Register / Login
  3. Go to Dashboard → API Keys
  4. Copy your API key

Step 3: Your First API Call

from transcend_sdk import TranscendClient

# Initialize with your API key
client = TranscendClient(api_key="YOUR_API_KEY")

# Calculate a route (Madrid → Barcelona)
route = client.route.calculate(
    origin_lat=40.4168,     # Madrid
    origin_lon=-3.7038,
    destiny_lat=41.3874,     # Barcelona
    destiny_lon=2.1686,
)

print(f"Distance: {route.distance / 1000:.1f} km")
print(f"Duration: {route.duration / 3600:.1f} hours")
print(f"Polyline: {route.polyline[:50]}...")

client.close()

Expected output:

Distance: 623.5 km
Duration: 5.8 hours
Polyline: _p~iF~ps|U_ulLnnqC_mqNvxq`@gFpqjB...

What Just Happened?

  1. TranscendClient connects to the TRANSCEND API
  2. client.route.calculate() sends coordinates
  3. API returns route with distance, duration, polyline

What's Next?

Troubleshooting

"401 Unauthorized"

  • Check your API key is correct
  • Make sure key is active in dashboard

"Connection Error"

Need Help?

Clone this wiki locally