ForHosting KIT · Strumenti per sviluppatori

Calcolatore dell’errore percentuale assoluto medio (MAPE)

Questa calcolatrice confronta una serie ordinata di valori osservati con una serie di previsioni della stessa dimensione e restituisce la media delle differenze percentuali assolute.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Il MAPE trasforma gli errori in una percentuale facile da comunicare tra previsioni con scale diverse. Inserisca i valori corrispondenti nello stesso ordine per ottenere la percentuale e il numero di coppie esaminate. Lo strumento rifiuta ogni osservazione pari a zero, perché l’errore percentuale non è definito quando il denominatore è zero e produrrebbe una misura fuorviante nei rapporti.

Prepari valori osservati e previsti allineati

Predisponga due array che descrivano gli stessi eventi nel medesimo ordine. La prima osservazione deve corrispondere alla prima previsione, la seconda alla seconda e così via. Gli array devono avere uguale lunghezza, contenere almeno un numero finito e rispettare il limite pubblicato. Nessuna osservazione può essere zero, poiché costituisce il denominatore. Le previsioni possono invece essere zero o negative quando il contesto lo consente. Non usi null, stringhe vuote, numeri in forma testuale, Infinity o NaN: sono ammessi soltanto numeri JSON finiti. Controlli inoltre che le unità coincidano; confrontare ricavi in euro con previsioni in migliaia di euro rende il risultato privo di senso. Invii i dati nei campi observed e predicted. La risposta riporta mape come percentuale e count come numero di coppie valutate.

Comprenda come viene calcolata la percentuale

Per ogni coppia, la calcolatrice sottrae la previsione dall’osservazione, prende il valore assoluto della differenza e lo divide per l’osservazione secondo la formula standard. Calcola poi la media dei rapporti e moltiplica il risultato per 100. Un mape di 8.5 indica quindi uno scarto medio dell’8.5 per cento, senza specificare se le singole previsioni fossero superiori o inferiori. Il valore assoluto impedisce agli errori positivi e negativi di annullarsi. Ogni coppia ha lo stesso peso, indipendentemente dalla grandezza; una piccola osservazione può pertanto generare una percentuale enorme. Il calcolo deterministico in virgola mobile non viene arrotondato, così Lei può scegliere la precisione adatta al rapporto. Il campo count conferma quante coppie sono state incluse.

Interpreti il MAPE con attenzione

Il MAPE è particolarmente utile quando le osservazioni sono diverse da zero, condividono una scala di rapporti significativa e le differenze percentuali rispondono alla domanda in esame. È comune nelle previsioni di domanda, traffico, vendite e scorte. Confronti soltanto insiemi preparati in modo coerente, perché cambiare periodo o composizione può modificare molto la misura. Faccia attenzione ai valori prossimi a zero: un errore assoluto modesto può dominare la media. I valori negativi sono accettati matematicamente, ma possono essere difficili da interpretare. Il MAPE non mostra distorsione, andamento temporale o distribuzione degli errori. Lo abbini a una metrica con segno se conta la sovrastima, oppure consideri MAE, RMSE, WAPE o una misura specifica quando gli zeri sono comuni. L’API costa $0.002 per richiesta e rifiuta esplicitamente gli input non validi.

Casi d'uso

Valutare le previsioni della domanda

Confronti la domanda settimanale prevista con le vendite osservate non nulle e comunichi l’errore medio in percentuale.

Monitorare le versioni dei modelli

Calcoli la stessa metrica per modelli candidati e verifichi se la precisione percentuale migliora.

Controllare le stime di pianificazione

Misuri quanto budget, traffico o capacità stimati si siano avvicinati ai valori definitivi.

Domande frequenti

Che cosa significa il valore MAPE restituito?

È l’errore percentuale assoluto medio espresso in percentuale. Un valore di 7 indica un errore assoluto medio del 7 per cento.

Perché le osservazioni pari a zero vengono rifiutate?

Ogni errore percentuale divide per l’osservazione. La divisione per zero non è definita, quindi l’intero input viene rifiutato.

I due array devono avere la stessa lunghezza?

Sì. Ogni osservazione richiede esattamente una previsione corrispondente; lunghezze diverse non sono valide.

La calcolatrice arrotonda il risultato?

No. Restituisce il risultato deterministico in virgola mobile affinché Lei scelga la precisione appropriata.

Le osservazioni possono essere negative?

Sì, sono ammessi valori negativi finiti, sebbene il MAPE possa risultare meno intuitivo quando il segno ha un significato specifico.

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/stat/mape-error

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/stat/mape-error \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"observed":[100,200,50,400],"predicted":[110,190,55,360]}'

const res = await fetch("https://api.kit.forhosting.com/stat/mape-error", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "observed": [
      100,
      200,
      50,
      400
    ],
    "predicted": [
      110,
      190,
      55,
      360
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/stat/mape-error",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "observed": [
        100,
        200,
        50,
        400
    ],
    "predicted": [
        110,
        190,
        55,
        360
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/mape-error", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"observed":[100,200,50,400],"predicted":[110,190,55,360]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"observed":[100,200,50,400],"predicted":[110,190,55,360]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/mape-error", 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

{
  "observed": [
    100,
    200,
    50,
    400
  ],
  "predicted": [
    110,
    190,
    55,
    360
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "stat.mape_error",
  "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.

Limiti

max_items 100000

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 →