پلتفرم برنامه نویس Mariner GPS Tools

نمای کلی و شروع سریع

از همان محاسبه‌گرهای ناوبری آزموده‌شدهٔ Mariner GPS Tools از طریق JSON REST API یا سرور Model Context Protocol استفاده کنید.

REST یا MCP را انتخاب کنید

هر دو رابط از همان موتور محاسبه و همان مدل مجوزها استفاده می‌کنند. برای برنامه‌ها و اسکریپت‌هایی که هر درخواست را خودتان کنترل می‌کنید از REST با کلید API استفاده کنید. وقتی قرار است یک دستیار یا عامل هوش مصنوعی ابزارهای موجود را کشف کند، شِماهای آن‌ها را بفهمد و خودش محاسبهٔ درست را انتخاب کند، از MCP استفاده کنید.

REST API

درخواست های مستقیم و نسخه شده

محاسبات ناوبری تماس از برنامه ها، خدمات، اتوماسیون ها و اسکریپت ها.

https://marinergps.tools/api/v1

سرور MCP

ابزارهایی برای عوامل هوش مصنوعی

اجازه دهید عوامل سازگار با MCP قابلیت های موجود را کشف کنند و محاسبه مناسب را انتخاب کنند.

https://marinergps.tools/mcp

احراز هویت

دو روش ورود به همان موتور محاسبه می‌رسند. کلاینت‌های تعاملی هوش مصنوعی به سرور MCP متصل می‌شوند و دسترسی را با OAuth در مرورگر مجوز می‌دهند. برنامه‌ها، سرویس‌ها، اسکریپت‌ها و یکپارچه‌سازی‌های دستی از کلید Mariner GPS Tools API استفاده می‌کنند که به‌صورت توکن Bearer ارسال می‌شود. ایجاد کلیدها رایگان است و می‌توان آن‌ها را هر زمان چرخاند یا باطل کرد.

یک کلید API ایجاد کنید

هدر Authorizationhttp

Authorization: Bearer mrt_live_...

راه اندازی سریع REST

یک درخواست JSON را با استفاده از کلید API به هر نقطه پایانی REST نسخه شده ارسال کنید. پاسخ ها از یک سازگار استفاده می کنندok, data, وerrorساختار در تمام ابزارهای محاسباتی

یک بلبرینگ را محاسبه کنیدshell

curl -X POST https://marinergps.tools/api/v1/bearing \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "from": { "lat": 50.1, "lng": -4.2 },
    "to": { "lat": 49.8, "lng": -3.1 }
  }'

راه اندازی سریع MCP

آدرس سرور را به یک کلاینت هوش مصنوعی سازگار اضافه کنید و وقتی صفحهٔ مجوز Mariner Tools باز شد، دسترسی را در مرورگر خود تأیید کنید. کلاینت تنظیمات ورود و ابزارهای موجود را به‌طور خودکار کشف می‌کند، بدون هیچ کلید یا توکنی برای کپی.

آدرس سرورhttp

https://marinergps.tools/mcp

راهنمای راه‌اندازی گام‌به‌گام

جایگزین: پیکربندی دستی با کلید API

کلاینت‌های بدون مجوزدهی مرورگری و یکپارچه‌سازی‌های برنامه‌نویسی‌شده می‌توانند به‌جای آن یک کلید API بفرستند:

پیکربندی مشتری MCPjson

{
  "mcpServers": {
    "mariner-tools": {
      "url": "https://marinergps.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

فرمت پاسخ REST

پاسخ های موفق REST نتیجه محاسبه شده را در برمی گرداندdata. خرابی‌های اعتبارسنجی و درخواست، یک کد خطای پایدار قابل خواندن توسط ماشین را در کنار یک پیام قابل خواندن توسط انسان بازمی‌گردانند.

JSON

{
  "ok": true,
  "data": {
    "degrees": 112.7,
    "compass": "ESE"
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Invalid bearing input."
  }
}