ForHosting KIT · Strumenti per sviluppatori

Distanza 3D

Questo calcolatore di distanza tridimensionale combina la distanza orizzontale misurata sul terreno con la differenza di quota fra due punti.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Considera le misure come cateti perpendicolari di un triangolo rettangolo e restituisce la distanza inclinata diretta. Usi la stessa unità di lunghezza per entrambi i dati — metri, piedi, chilometri o altro — e il risultato resterà in tale unità. Il calcolo è deterministico, non richiede coordinate o proiezioni cartografiche e rifiuta chiaramente valori mancanti, non finiti o una distanza orizzontale negativa.

Trasformi distanza in pianta e dislivello in distanza inclinata

Una carta, un progetto di cantiere o una misura sul campo spesso fornisce la separazione orizzontale, mentre un livello, una carta a curve o un modello altimetrico indica la differenza verticale. Questi valori descrivono componenti perpendicolari di un segmento rettilineo in tre dimensioni. Il calcolatore applica il teorema di Pitagora: eleva al quadrato la distanza orizzontale e il dislivello, somma i quadrati e ne estrae la radice. Per esempio, 120 metri orizzontali e 50 metri di dislivello producono 130 metri di distanza diretta. Il segno del dislivello non modifica la lunghezza, perché elevandolo al quadrato una salita e una discesa uguali contribuiscono allo stesso modo. La risposta conserva comunque il segno per indicare se il secondo punto è sopra o sotto il primo. Questa funzione è destinata ai casi in cui la distanza orizzontale è già nota. Non la ricava da latitudine e longitudine e non modella un percorso che segue le asperità del terreno. Il valore restituito è la distanza rettilinea fra i punti definita dalle due misure perpendicolari.

Scelga dati coerenti e interpreti correttamente il risultato

Inserisca horizontal_distance come numero finito non negativo. Definisca elevation_difference come quota del secondo punto meno quota del primo: un valore positivo indica che il secondo è più alto, uno negativo che è più basso. Entrambi i numeri devono usare la stessa unità. Se la distanza orizzontale è in metri e il dislivello in piedi, la formula verrà eseguita ma il risultato non avrà significato fisico; converta prima una misura. Non serve un campo unità perché la relazione pitagorica ne è indipendente. Dati in metri producono metri e dati in piedi producono piedi. Con dislivello zero, la distanza 3D equivale a quella orizzontale. Con distanza orizzontale zero, il risultato è il valore assoluto del dislivello. La distanza diretta non può essere minore di nessuna componente. La risposta riporta i dati normalizzati, distance_3d e la formula per spiegare il calcolo. Ogni elemento valido tramite API costa $0.002; gli input errati vengono rifiutati anziché trasformati in zeri ingannevoli o valori JSON non numerici.

Consideri le ipotesi geometriche e i limiti pratici

Usa lo strumento web per controlli singoli e l’API quando vuoi integrare la stessa capacità in un flusso automatizzato.

Casi d'uso

Verifiche topografiche

Combini una linea orizzontale misurata con il cambio di quota per ottenerne la distanza inclinata diretta.

Stime di cavi e tubazioni

Stimi il tratto rettilineo fra estremità separate in orizzontale e verticale prima di aggiungere i margini di posa.

Analisi di tratti escursionistici

Confronti la distanza in pianta con la distanza 3D fra punti di cui sono note le quote iniziale e finale.

Domande frequenti

Quale formula viene usata?

Il risultato è la radice quadrata della distanza orizzontale al quadrato più il dislivello al quadrato.

Quali unità posso usare?

Va bene qualsiasi unità di lunghezza, purché entrambe le entrate usino la stessa. Il risultato mantiene tale unità.

Il dislivello può essere negativo?

Sì. Un valore negativo indica che il secondo punto è più basso; il suo modulo contribuisce come quello di un valore positivo.

È la distanza percorsa sul terreno?

No. È la distanza rettilinea fra due punti, non la lunghezza di un percorso tortuoso o di una superficie irregolare.

Posso usare latitudine e longitudine?

Non direttamente. Calcoli prima una distanza orizzontale adeguata e la combini qui con il dislivello.

Quanto costa un calcolo tramite API?

Ogni elemento valido costa $0.002; il calcolatore nel browser è gratuito.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/geo/distance-3d

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/geo/distance-3d \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"horizontal_distance":120,"elevation_difference":50}'

const res = await fetch("https://api.kit.forhosting.com/geo/distance-3d", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "horizontal_distance": 120,
    "elevation_difference": 50
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/distance-3d",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "horizontal_distance": 120,
    "elevation_difference": 50
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/distance-3d", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"horizontal_distance":120,"elevation_difference":50}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"horizontal_distance":120,"elevation_difference":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/distance-3d", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "horizontal_distance": 120,
  "elevation_difference": 50
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.distance_3d",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →