Mariner GPS Tools -kehittäjäalusta

Yleiskatsaus ja pikaopas

Käytä samoja testattuja navigointilaskureita kuin Mariner GPS Tools JSON REST API:n tai Model Context Protocol -palvelimen kautta.

Valitse REST tai MCP

Molemmat rajapinnat käyttävät samaa laskentamoottoria ja oikeusmallia. Käytä RESTiä API-avaimella sovelluksissa ja skripteissä, joissa hallitset jokaista pyyntöä. Käytä MCP:tä, kun tekoälyavustajan tai agentin pitää löytää saatavilla olevat työkalut, ymmärtää niiden skeemat ja valita oikea laskenta itse.

REST API

Suorat, versioidut pyynnöt

Puhelunavigointilaskelmat sovelluksista, palveluista, automaatioista ja skripteistä.

https://marinergps.tools/api/v1

MCP-palvelin

Työkalut tekoälyagenteille

Anna MCP-yhteensopivien agenttien löytää käytettävissä olevat ominaisuudet ja valita sopiva laskelma.

https://marinergps.tools/mcp

Todennus

Kaksi kirjautumistapaa käyttävät samaa laskentamoottoria. Vuorovaikutteiset tekoälyasiakkaat yhdistävät MCP-palvelimeen ja valtuuttavat pääsyn selaimessa OAuthilla. Sovellukset, palvelut, skriptit ja manuaaliset integraatiot käyttävät Mariner GPS Tools API-avainta Bearer-tunnisteena. Avaimet ovat ilmaisia luoda, ja ne voi vaihtaa tai perua milloin tahansa.

Luo API-avain

Authorization otsikkohttp

Authorization: Bearer mrt_live_...

REST pikakäynnistys

Lähetä JSON-pyyntö mihin tahansa versioituun REST-päätepisteeseen käyttämällä API-avainta. Vastauksissa käytetään johdonmukaisuuttaok, data, jaerrorrakenne kaikissa laskentatyökaluissa.

Laske laakerishell

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 pikakäynnistys

Lisää palvelimen URL yhteensopivaan tekoälyasiakkaaseen ja hyväksy pääsy selaimessasi, kun Mariner Toolsin valtuutussivu avautuu. Asiakas löytää kirjautumisasetukset ja saatavilla olevat työkalut automaattisesti, eikä avaimia tai tunnisteita tarvitse kopioida.

Palvelimen URLhttp

https://marinergps.tools/mcp

Vaiheittainen käyttöönotto-opas

Vaihtoehto: manuaalinen määritys API-avaimella

Asiakkaat ilman selainvaltuutusta sekä ohjelmalliset integraatiot voivat lähettää sen sijaan API-avaimen:

MCP-asiakaskokoonpanojson

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

REST vastausmuoto

Onnistuneet REST-vastaukset palauttavat lasketun tuloksendata. Vahvistus- ja pyyntövirheet palauttavat vakaan koneellisesti luettavan virhekoodin sekä ihmisen luettavissa olevan viestin.

JSON

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

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