npm install @navvo/sdk
# أو: pnpm add @navvo/sdk / yarn add @navvo/sdk

import { NavvoClient } from "@navvo/sdk";

const navvo = NavvoClient.fromEnv();              // يستخدم $NAVVO_API_KEY
const navvo2 = new NavvoClient({ apiKey: "nvvo_your_key_here" });

import { NavvoClient } from "@navvo/sdk";

const navvo = new NavvoClient();

// ترميز جغرافي أمامي — تُحوَّل الإحداثيات النصية إلى أرقام تلقائيًا
const hits = await navvo.geocode("مستشفى العبدلي، عمّان", { limit: 5 });
console.log(hits[0].lat, hits[0].lng, hits[0].displayName);

// خطّط مسارًا — تمرّر { lat, lng } والمكتبة تُسلسل lon/lat على الشبكة
const plan = await navvo.route({
  locations: [
    { lat: 31.95, lng: 35.91, name: "A" },
    { lat: 31.99, lng: 35.95, name: "B" },
  ],
  costing: "auto",
});
const trip = plan.engine?.data?.trip;
console.log("الوقت المتوقّع بالثواني:", trip?.summary?.time);

// فُكّ خطّ المرحلة (polyline6) إلى نقاط
const line = NavvoClient.decodePolyline(trip?.legs?.[0]?.shape ?? "");

// بيانات حيّة وفق الظروف
const wx = await navvo.weatherPoint(31.95, 35.91);
const inc = await navvo.incidents({ bbox: { west: 35.85, south: 31.9, east: 35.99, north: 31.99 }, limit: 10 });

import {
  NavvoRateLimitError,
  NavvoForbiddenError,
  NavvoServiceUnavailableError,
} from "@navvo/sdk";

try {
  const r = await navvo.geocode("مستشفى العبدلي، عمّان");
} catch (e) {
  if (e instanceof NavvoRateLimitError) {
    console.warn("تجاوز الحدّ، أعد المحاولة بعد", e.retryAfter, "ثانية");
  } else if (e instanceof NavvoForbiddenError) {
    console.error("مشكلة نطاق/حصّة:", e.reason ?? e.message);
  } else if (e instanceof NavvoServiceUnavailableError) {
    console.error("محرّك الترميز معطّل مؤقتًا — استخدم بديلًا");
  } else {
    throw e;
  }
}

const ac = new AbortController();
const p = navvo.list({ category: "cafe" }, { signal: ac.signal });
setTimeout(() => ac.abort(), 1000);