Plateforme d'agents et d'API Mariner GPS Tools

Convertir les vitesses

Convertir entre nœuds, miles par heure, kilomètres par heure, mètres par seconde et pieds par seconde.

Interfaces

POST

Point de terminaison REST/api/v1/speed/convert

MCP

Nom de l'outilconvert_speed

Demande

Envoyez la demande sous le nom JSON. Les clients MCP transmettent les mêmes champs que les arguments de l'outil.

cURLshell

curl -X POST https://marinergps.tools/api/v1/speed/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "value": 12,
  "from": "kn",
  "to": "kmh"
}'

Corps de la demandejson

{
  "value": 12,
  "from": "kn",
  "to": "kmh"
}

Réponse

REST enveloppe le résultat du calcul dans l'enveloppe de réussite standard. MCP renvoie les mêmes données de calcul sous forme de sortie structurée de l'outil.

JSON

{
  "ok": true,
  "data": {
    "input": {
      "value": 12,
      "from": "kn",
      "to": "kmh"
    },
    "conversions": {
      "kn": 12,
      "mph": 13.80935337628251,
      "kmh": 22.224,
      "ms": 6.173333333333334,
      "fts": 20.253718285214347
    },
    "result": 22.224
  }
}

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

Schémas

Les définitions ci-dessous montrent le schéma JSON complet utilisé pour valider les entrées et décrire les sorties.

Schéma d’entrée

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "value": {
      "type": "number",
      "description": "Speed value to convert."
    },
    "from": {
      "type": "string",
      "enum": [
        "kn",
        "mph",
        "kmh",
        "ms",
        "fts"
      ],
      "description": "Input speed unit."
    },
    "to": {
      "type": "string",
      "enum": [
        "kn",
        "mph",
        "kmh",
        "ms",
        "fts"
      ],
      "description": "Optional target unit. When omitted, all units are returned."
    }
  },
  "required": [
    "value",
    "from"
  ]
}

Schéma de sortie

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "input": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "value": {
          "type": "number"
        },
        "from": {
          "type": "string",
          "enum": [
            "kn",
            "mph",
            "kmh",
            "ms",
            "fts"
          ]
        },
        "to": {
          "type": "string",
          "enum": [
            "kn",
            "mph",
            "kmh",
            "ms",
            "fts"
          ]
        }
      },
      "required": [
        "value",
        "from"
      ]
    },
    "conversions": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "kn": {
          "type": "number"
        },
        "mph": {
          "type": "number"
        },
        "kmh": {
          "type": "number"
        },
        "ms": {
          "type": "number"
        },
        "fts": {
          "type": "number"
        }
      },
      "required": [
        "kn",
        "mph",
        "kmh",
        "ms",
        "fts"
      ]
    },
    "result": {
      "type": "number",
      "description": "Target-unit result when a target unit is supplied."
    }
  },
  "required": [
    "input",
    "conversions"
  ]
}