Mariner GPS Tools एजेंट और API प्लेटफ़ॉर्म
क्रॉस ट्रैक एरर (XTE) निकालें
महावृत्त मार्ग से किसी पोज़िशन की लंबवत दूरी की गणना करें।
इंटरफ़ेस
POST
REST समापन बिंदु
/api/v1/xteMCP
उपकरण का नाम
calculate_cross_track_errorनिवेदन
अनुरोध को JSON के रूप में भेजें। MCP क्लाइंट टूल तर्कों के समान फ़ील्ड पास करते हैं।
cURLshell
curl -X POST https://marinergps.tools/api/v1/xte \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"start": {
"lat": 50,
"lng": -4
},
"end": {
"lat": 50,
"lng": -2
},
"position": {
"lat": 50.2,
"lng": -3
}
}'निकाय से अनुरोध करेंjson
{
"start": {
"lat": 50,
"lng": -4
},
"end": {
"lat": 50,
"lng": -2
},
"position": {
"lat": 50.2,
"lng": -3
}
}प्रतिक्रिया
REST गणना परिणाम को मानक सफलता लिफाफे में लपेटता है। MCP वही गणना डेटा संरचित टूल आउटपुट के रूप में लौटाता है।
JSON
{
"ok": true,
"data": {
"xte": {
"km": 21.761189017395775,
"nm": 11.75010633826597,
"mi": 13.52177178092823,
"m": 21761.189017395776,
"ft": 71394.95500330106
},
"side": "port",
"alongTrack": {
"km": 71.47269030854304,
"nm": 38.592179440929975,
"mi": 44.4110570497097,
"m": 71472.69030854304,
"ft": 234490.3812224672
},
"remaining": {
"km": 71.47269030856953,
"nm": 38.59217944094428,
"mi": 44.41105704972615,
"m": 71472.69030856952,
"ft": 234490.3812225541
},
"nearestPoint": {
"lat": 50.00429719577797,
"lng": -3.0000000000002274
},
"beforeStart": false,
"beyondEnd": false
}
}{
"ok": false,
"error": {
"code": "invalid_request",
"message": "Invalid request input."
}
}स्कीमा
नीचे दी गई परिभाषाएँ इनपुट को मान्य करने और आउटपुट का वर्णन करने के लिए उपयोग की जाने वाली संपूर्ण JSON स्कीमा दिखाती हैं।
इनपुट स्कीमा
{
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"type": "object",
"additionalProperties": false,
"properties": {
"lat": {
"type": "string",
"description": "Latitude as signed decimal degrees (-33.8688), decimal degrees with a hemisphere letter (33.8688° S), degrees and decimal minutes (33° 52.13′ S) or DMS (51° 30′ 26.4″ N). S is negative. Do not combine a sign with a hemisphere letter."
},
"lng": {
"type": "string",
"description": "Longitude as signed decimal degrees (-4.15), decimal degrees with a hemisphere letter (4.15° W), degrees and decimal minutes (4° 09.0′ W) or DMS (0° 07′ 39″ W). W is negative. Do not combine a sign with a hemisphere letter."
}
},
"required": [
"lat",
"lng"
],
"description": "Track start waypoint (A)."
},
"end": {
"type": "object",
"additionalProperties": false,
"properties": {
"lat": {
"type": "string",
"description": "Latitude as signed decimal degrees (-33.8688), decimal degrees with a hemisphere letter (33.8688° S), degrees and decimal minutes (33° 52.13′ S) or DMS (51° 30′ 26.4″ N). S is negative. Do not combine a sign with a hemisphere letter."
},
"lng": {
"type": "string",
"description": "Longitude as signed decimal degrees (-4.15), decimal degrees with a hemisphere letter (4.15° W), degrees and decimal minutes (4° 09.0′ W) or DMS (0° 07′ 39″ W). W is negative. Do not combine a sign with a hemisphere letter."
}
},
"required": [
"lat",
"lng"
],
"description": "Track end waypoint (B)."
},
"position": {
"type": "object",
"additionalProperties": false,
"properties": {
"lat": {
"type": "string",
"description": "Latitude as signed decimal degrees (-33.8688), decimal degrees with a hemisphere letter (33.8688° S), degrees and decimal minutes (33° 52.13′ S) or DMS (51° 30′ 26.4″ N). S is negative. Do not combine a sign with a hemisphere letter."
},
"lng": {
"type": "string",
"description": "Longitude as signed decimal degrees (-4.15), decimal degrees with a hemisphere letter (4.15° W), degrees and decimal minutes (4° 09.0′ W) or DMS (0° 07′ 39″ W). W is negative. Do not combine a sign with a hemisphere letter."
}
},
"required": [
"lat",
"lng"
],
"description": "Vessel position (P)."
}
},
"required": [
"start",
"end",
"position"
]
}आउटपुट स्कीमा
{
"type": "object",
"additionalProperties": false,
"properties": {
"xte": {
"type": "object",
"additionalProperties": false,
"properties": {
"nm": {
"type": "number"
},
"mi": {
"type": "number"
},
"km": {
"type": "number"
},
"m": {
"type": "number"
},
"ft": {
"type": "number"
}
},
"required": [
"nm",
"mi",
"km",
"m",
"ft"
],
"description": "Cross track error magnitude — perpendicular distance from position to track."
},
"side": {
"type": "string",
"enum": [
"port",
"starboard",
"on-track"
],
"description": "Side of the track the position lies on, travelling start → end."
},
"alongTrack": {
"type": "object",
"additionalProperties": false,
"properties": {
"nm": {
"type": "number"
},
"mi": {
"type": "number"
},
"km": {
"type": "number"
},
"m": {
"type": "number"
},
"ft": {
"type": "number"
}
},
"required": [
"nm",
"mi",
"km",
"m",
"ft"
],
"description": "Distance from start along the track to the point abeam of the position. Negative when the position is abeam a point behind the start."
},
"remaining": {
"type": "object",
"additionalProperties": false,
"properties": {
"nm": {
"type": "number"
},
"mi": {
"type": "number"
},
"km": {
"type": "number"
},
"m": {
"type": "number"
},
"ft": {
"type": "number"
}
},
"required": [
"nm",
"mi",
"km",
"m",
"ft"
],
"description": "Distance remaining along the track from the abeam point to the end waypoint."
},
"nearestPoint": {
"type": "object",
"additionalProperties": false,
"description": "Nearest point on the track (foot of the perpendicular), decimal degrees.",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
]
},
"beforeStart": {
"type": "boolean",
"description": "True when the abeam point falls before the start waypoint."
},
"beyondEnd": {
"type": "boolean",
"description": "True when the abeam point falls beyond the end waypoint."
}
},
"required": [
"xte",
"side",
"alongTrack",
"remaining",
"nearestPoint",
"beforeStart",
"beyondEnd"
]
}MCP बेंचमार्क परिणाम
इस टूल के लिए Mariner GPS Tools MCP सर्वर संलग्न होने पर और उसके बिना मापा गया।
सितंबर 2026 में मापा गया · 9 मॉडल · 5 नेविगेशन केस · 3 पुनरावृत्तियाँ · 270 प्रेक्षण · प्रोडक्शन MCP
बेंचमार्क कार्यप्रणाली और पूर्ण परिणामAI क्लाइंट से कनेक्ट करें