> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Mappa radar
> Rappresenta le aziende sul Syrto Radar come grafico interattivo.
`syrto_radar_map` posiziona le aziende sul Syrto Radar - un grafico di posizionamento a due assi dove a destra significa più grande e in alto significa più efficiente. Restituisce un widget interattivo più un riepilogo testuale di ciò che è a schermo.
I due punteggi radar vanno da 0 a 100 e sono calcolati sull'intero database Syrto anziché all'interno di un settore, quindi aziende di settori **diversi** stanno sugli stessi assi e possono essere confrontate direttamente. Ogni azienda traccia un percorso attraverso gli esercizi depositati che termina con una freccia sull'ultimo, mentre gli anni di previsione proseguono con una linea tratteggiata.
Il grafico interattivo richiede un host che renderizzi le MCP App. Dove il grafico non può essere mostrato, il riepilogo testuale resta comunque autosufficiente. Per ottenere lo stesso grafico come immagine incorporabile, usa [`syrto_radar_chart`](/it/mcp/tools/radar-chart).
## Quando usare questo strumento
* Confrontare, ordinare, fare benchmark o posizionare due o più aziende a colpo d'occhio
* Vedere in che direzione si sta muovendo un'azienda, non solo dove si trova
* Collocare un'azienda rispetto al suo settore, alla sua regione o alla sua fascia dimensionale come linee di riferimento
**Strumenti correlati:** Per il valore esatto di una metrica, usa [Confronta aziende](/it/mcp/tools/compare-companies). Per il profilo tematico di una singola azienda, usa [Spider graph](/it/mcp/tools/spider-graphs). Per un'azienda in profondità, usa [Analisi aziendale](/it/mcp/tools/company-analysis).
I punteggi non sono percentili e 50 non è una media - è solo il punto medio della scala, e la popolazione vi è distribuita in modo molto disomogeneo. Leggi le posizioni rispetto alle altre aziende sulla mappa, non rispetto al centro.
## Argomenti
Cinque fonti portano aziende su un'unica mappa. Tutto ciò che passa per `company_id`, `peer_ids`, `peer_filters` e `company_lists` concorre a un unico limite di 148 aziende.
L'azienda al centro della mappa, da [`syrto_find_company`](/it/mcp/tools/find-company) o [`syrto_lookup_companies_by_tax_id`](/it/mcp/tools/lookup-companies-by-tax-id). Disegnata con un colore proprio e sempre etichettata. Facoltativa - una mappa può essere composta solo da liste di aziende e linee di riferimento, senza nessuna in evidenza.
Altre aziende da rappresentare, per ID. Usalo quando le aziende sono nominate anziché raggruppate o descritte.
Un gruppo di peer descritto per criteri invece che elencato per ID - "il suo settore", "i trasformatori di nocciole in Piemonte". I suoi membri vengono rappresentati singolarmente.
| Campo | Tipo | Descrizione |
| --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `filters` | object | Quali aziende rappresentare, come lo stesso oggetto filtri accettato da [`syrto_search_companies`](/it/mcp/tools/search-companies#sezioni-dei-filtri). È richiesto almeno un filtro. |
| `limit` | integer | Quante aziende prendere dalla popolazione. Predefinito 25, massimo 148. Recuperate 25 alla volta, quindi un numero elevato costa più chiamate. |
| `sort_by` | object | Quali aziende il limite trattiene - le più grandi per ricavi, le migliori per ROE. Omettilo e l'ordine è quello predefinito dell'API, quindi le aziende disegnate sono un campione arbitrario della popolazione e non le sue prime per qualcosa. |
| `year` | integer | Anno fiscale in cui vengono valutati i filtri. Decide chi fa parte della popolazione, non quali anni vengono disegnati. Predefinito: l'ultimo anno depositato dalla maggior parte delle aziende. |
Insiemi di aziende con un nome, ciascuno disegnato con un colore proprio - un portafoglio contro una watchlist, le vittorie di quest'anno contro quelle dell'anno scorso. Fino a 4 liste. Ogni voce ha:
* `name` - etichetta dell'insieme, es. `"Portafoglio"`. Mostrata al passaggio del mouse e usata quando viene riportata la selezione dell'utente.
* `company_ids` - gli ID delle aziende appartenenti all'insieme.
Linee di riferimento, ciascuna una media di popolazione con un nome a tua scelta. Fino a 4. Gli assi sono globali e non portano alcun riferimento settoriale, quindi è così che una mappa risponde a "rispetto a chi". Ogni voce ha:
* `name` - l'etichetta disegnata sulla linea, es. `"Trasformatori di nocciole in Piemonte"`. Indica quale popolazione media - è l'unica cosa che distingue una linea di riferimento da un'altra.
* `filters` - quali aziende mediare, come lo stesso oggetto filtri accettato da [`syrto_search_companies`](/it/mcp/tools/search-companies#sezioni-dei-filtri).
L'oggetto `filters` in `peer_filters` e `aggregates` include la sezione `company_ids`, quindi una linea di riferimento o un gruppo di peer può essere un elenco esplicito di aziende. Un elenco di ID **puro** - senza altre sezioni di filtro - salta il filtro implicito sull'anno di appartenenza e si comporta come `peer_ids`: ogni azienda elencata entra nel gruppo, contribuendo con gli anni che ha depositato.
L'aggiunta di un qualsiasi criterio dipendente dall'anno, o di un `peer_filters.year` esplicito, ripristina quel vincolo. L'appartenenza viene allora fissata una volta sola, a quell'anno, e un'azienda elencata che non ha depositato quell'anno è assente dall'**intera** linea di riferimento, non solo da uno dei suoi anni.
Disegna l'intero percorso di ogni azienda (`true`, predefinito), oppure un solo punto per azienda sull'ultimo esercizio depositato (`false`). Disattivarlo è ciò che rende leggibile una mappa di venti peer quando i percorsi si incrociano. Su questo strumento è solo lo stato di apertura del grafico - il lettore può rimettere i percorsi con il pulsante Trajectories del grafico stesso.
`"en"` per l'inglese (predefinito) o `"it"` per l'italiano.
## Risposta
Un riepilogo di ciò che è a schermo. La mappa completa anno per anno va al grafico renderizzato e non viene ripetuta nel riepilogo.
I nomi degli assi `x` e `y`.
Una voce per ogni azienda sulla mappa:
* `id`, `name` - identità
* `role` - `"focus"`, `"peer"` o `"aggregate"` (una linea di riferimento, quindi una media di popolazione e non un'azienda)
* `group` - il nome della lista `company_lists` da cui proviene l'azienda
* `color` - il colore con cui è disegnata, come nome e non come esadecimale: blu per l'azienda focus, viola per le aziende in nessuna lista, poi verde/rosa/lime/magenta per lista e ambra/arancione/giallo/ardesia per linea di riferimento, nell'ordine in cui sono state passate
* `consolidated` - `false` per i valori individuali dell'azienda, `true` per quelli del suo gruppo, assente su un aggregato. Due voci possono avere lo stesso nome e differire solo qui.
* `latest` - la sua posizione più recente, come punto `{year, size, efficiency}` sugli assi 0-100
* `start` - la sua posizione depositata più antica, omessa quando è depositato un solo anno. Da `start` a `latest` è l'andamento.
* `forecast` - dove termina la sua proiezione, omesso quando non c'è alcuna proiezione
* `dropped_years` - anni che non è stato possibile rappresentare. Un percorso che ne contiene uno non è la linea continua che sembra, e `latest` non è l'anno depositato più recente.
L'anno più recente disegnato sulla mappa.
Aziende richieste senza dati radar rappresentabili. Ogni azienda richiesta è o in `companies` o qui.
Linee di riferimento i cui filtri non hanno trovato alcuna corrispondenza.
Presente solo quando è stato passato `peer_filters`, indica cosa ha contribuito: aziende `selected`, di cui `plotted` con dati radar, e `more_available` quando la popolazione proseguiva oltre quanto disegnato. In quel caso il grafico mostra una porzione di quella popolazione e non il suo insieme.
Quando `unavailable_ids` o `unavailable_aggregates` non è vuoto, al grafico manca qualcosa che era stato richiesto, e il grafico stesso non può mostrarlo.
## Esempio
**Un'azienda rispetto a una lista di concorrenti, una di fornitori e due linee di riferimento:**
```json theme={null}
{
"company_id": "Zm86SVRfMTA2MTU1MTAwMTJfVTox",
"company_lists": [
{
"name": "Competitors",
"company_ids": [
"Zm86SVRfMDAxODI1NDAwNDdfVTox",
"Zm86SVRfODAwNTEyMTAwMTNfVTox",
"Zm86SVRfMDM3MjMwNDAwNDhfVTox"
]
},
{
"name": "Suppliers",
"company_ids": [
"Zm86SVRfMDMzNzM1NjAwNDhfVTox",
"Zm86SVRfMDIzMTI4NTAwNDlfVTox"
]
}
],
"aggregates": [
{
"name": "Piedmont food manufacturing",
"filters": { "anagraphic": { "nace": ["10"], "nuts": ["ITC1"] } }
},
{
"name": "Italian food manufacturing",
"filters": { "anagraphic": { "nace": ["10"], "country_code": "IT" } }
}
]
}
```
Questo produce il grafico all'inizio di questa pagina.
**Un'istantanea di una popolazione descritta, dalle più grandi:**
```json theme={null}
{
"company_id": "Zm86SVRfMTA2MTU1MTAwMTJfVTox",
"peer_filters": {
"filters": { "anagraphic": { "nace": ["10"], "nuts": ["ITC1"] } },
"limit": 20,
"sort_by": { "field": "metric", "metric_slug": "revenues_from_sales_and_services" },
"year": 2023
},
"trajectories": false
}
```