Riferimento API
Riferimento API
Un riferimento completo di tutte le API pubbliche disponibili in ciascun pacchetto.
Tipi
Country
| Campo | Tipo | Descrizione |
|---|---|---|
id | string | Identificatore univoco (es. "unitedStates") |
alpha2Code | string | ISO 3166-1 alpha-2 (es. "US") |
alpha3Code | string | ISO 3166-1 alpha-3 (es. "USA") |
numericCode | number | ISO 3166-1 numerico (es. 840) |
nativeName | string | Nome nativo del paese |
capital | string | Capitale |
mainLanguage | string | Codice della lingua principale |
languages | string[] | Codici di tutte le lingue parlate |
tld | string | Dominio di primo livello |
callingCode | number | Prefisso telefonico internazionale |
continent | string | Identificatore del continente |
currency | string | Codice della valuta |
Language
| Campo | Tipo | Descrizione |
|---|---|---|
id | string | Identificatore univoco (es. "english") |
code | string | Codice ISO 639-1 (es. "en") |
nativeName | string | Nome nella lingua stessa |
dialects | LanguageDialect[] | Varianti regionali |
defaultFlagCode | string? | Codice paese per la bandiera rappresentativa |
LanguageDialect
| Campo | Tipo | Descrizione |
|---|---|---|
id | string | Identificatore univoco |
code | string | Codice del dialetto |
nativeName | string | Nome nativo del dialetto |
flagCode | string? | Codice paese per la bandiera del dialetto |
Currency
| Campo | Tipo | Descrizione |
|---|---|---|
id | string | Identificatore univoco (es. "usd") |
code | string | Codice ISO 4217 (es. "USD") |
nativeName | string | Nome singolare (es. "US Dollar") |
nativeNamePlural | string | Nome plurale (es. "US Dollars") |
symbol | string | Simbolo della valuta (es. "$") |
Continent
| Campo | Tipo | Descrizione |
|---|---|---|
id | string | Identificatore univoco (es. "europe") |
code | string | Codice a due lettere (es. "EU") |
name | string | Nome visualizzato in inglese |
Funzioni di Ricerca
Paesi
GoDartTypeScript
// TypeScript
getCountryByAlpha2(code: string): Country | undefined
getCountryByAlpha3(code: string): Country | undefined
getCountriesByContinent(continent: string): Country[]
getCountriesInContinent(code: string): Country[]Lingue
GoDartTypeScript
// TypeScript
getLanguageByCode(code: string): Language | undefinedValute
GoDartTypeScript
// TypeScript
getCurrencyByCode(code: string): Currency | undefinedContinenti
GoDartTypeScript
// TypeScript
getContinentByCode(code: string): Continent | undefinedBandiere
GoDartTypeScript
// TypeScript
getFlag(alpha2: string): string | undefined
flags // Record<string, string>Bandiere Emoji
GoDartTypeScript
// TypeScript
getEmojiFlag(alpha2: string): stringEnum / Costanti
Ogni pacchetto fornisce costanti type-safe per tutti i codici:
GoDartTypeScript
// TypeScript — string enums
CountryCode.US // "US"
LanguageCode.FR // "FR"
CurrencyCode.EUR // "EUR"
ContinentCode.EU // "EU"Funzioni di Traduzione
Tutte le funzioni di traduzione accettano un codice entita e un codice locale, restituendo il nome localizzato.
Lingue disponibili: da, de, en, es, fr, it, zh
GoDartTypeScript
// TypeScript
getCountriesName(code: string, locale: string): string | undefined
getLanguagesName(code: string, locale: string): string | undefined
getCurrenciesName(code: string, locale: string): string | undefined
getContinentsName(code: string, locale: string): string | undefined
getCapitalsName(code: string, locale: string): string | undefinedMappe di Traduzione
Per l'accesso in blocco, sono disponibili le mappe di traduzione grezze:
GoDartTypeScript
// TypeScript
countriesTranslations // Record<string, Record<string, string>>
languagesTranslations
currenciesTranslations
continentsTranslations
capitalsTranslations