# `Faker.Address.It`
[🔗](https://github.com/artkay/fakerer/blob/v1.0.0/lib/faker/address/it.ex#L1)

Functions for generating addresses in Italian

# `building_number`

```elixir
@spec building_number() :: String.t()
```

Return random building number.

## Examples

    iex> Faker.Address.It.building_number()
    "154"
    iex> Faker.Address.It.building_number()
    "64"
    iex> Faker.Address.It.building_number()
    "1"
    iex> Faker.Address.It.building_number()
    "832"

# `city`

```elixir
@spec city() :: String.t()
```

Return city name.

## Examples

    iex> Faker.Address.It.city()
    "Dionigi Marittima"
    iex> Faker.Address.It.city()
    "Quarto Gennaro"
    iex> Faker.Address.It.city()
    "Sesto Maurizia"
    iex> Faker.Address.It.city()
    "Case di Taffy"

# `city_prefix`

```elixir
@spec city_prefix() :: String.t()
```

Return city prefix.

## Examples

    iex> Faker.Address.It.city_prefix()
    "Quarto"
    iex> Faker.Address.It.city_prefix()
    "Castello"
    iex> Faker.Address.It.city_prefix()
    "Quarto"
    iex> Faker.Address.It.city_prefix()
    "Santa"

# `city_suffix`

```elixir
@spec city_suffix() :: String.t()
```

Return city suffix.

## Examples

    iex> Faker.Address.It.city_suffix()
    "di sotto"
    iex> Faker.Address.It.city_suffix()
    "di sopra"
    iex> Faker.Address.It.city_suffix()
    "Marittima"

# `country`

```elixir
@spec country() :: String.t()
```

Return country.
List from http://publications.europa.eu/code/it/it-5000500.htm

## Examples

    iex> Faker.Address.It.country()
    "Etiopia"
    iex> Faker.Address.It.country()
    "Cipro"
    iex> Faker.Address.It.country()
    "Timor Leste"
    iex> Faker.Address.It.country()
    "Nicaragua"

# `country_code`

```elixir
@spec country_code() :: String.t()
```

Return country code.
List from http://publications.europa.eu/code/it/it-5000500.htm

## Examples

    iex> Faker.Address.It.country_code()
    "CO"
    iex> Faker.Address.It.country_code()
    "LV"

# `province`

```elixir
@spec province() :: String.t()
```

Return province name.
Data from https://dait.interno.gov.it/servizi-demografici/documentazione/anagaire-tabelle-comuni-province-consolati-statiterritori
If you call region(), province() or province_abbr() separately you'll end up with
inconsistent data. For example: "Lombardia", "Roma", "GE".
If you want consisten data call region_province_abbr() instead, which will return
something like ["Lombardia", "Milano", "MI"].

    ## Examples

    iex> Faker.Address.It.province()
    "Barletta-Andria-Trani"
    iex> Faker.Address.It.province()
    "Trento"
    iex> Faker.Address.It.province()
    "Pavia"
    iex> Faker.Address.It.province()
    "Caserta"

# `province_abbr`

```elixir
@spec province_abbr() :: String.t()
```

Return province code.
Data from https://dait.interno.gov.it/servizi-demografici/documentazione/anagaire-tabelle-comuni-province-consolati-statiterritori
If you call region(), province() or province_abbr() separately you'll end up with
inconsistent data. For example: "Lombardia", "Roma", "GE".
If you want consisten data call region_province_abbr() instead, which will return
something like ["Lombardia", "Milano", "MI"].

  ## Examples

    iex> Faker.Address.It.province_abbr()
    "BA"
    iex> Faker.Address.It.province_abbr()
    "TR"
    iex> Faker.Address.It.province_abbr()
    "PG"
    iex> Faker.Address.It.province_abbr()
    "CE"

# `region`

```elixir
@spec region() :: String.t()
```

Return region.
If you call region(), province() or province_abbr() separately you'll end up with
inconsistent data. For example: "Lombardia", "Roma", "GE".
If you want consisten data call region_province_abbr() instead, which will return
something like ["Lombardia", "Milano", "MI"].

    ## Examples

    iex> Faker.Address.It.region()
    "Molise"
    iex> Faker.Address.It.region()
    "Basilicata"
    iex> Faker.Address.It.region()
    "Toscana"
    iex> Faker.Address.It.region()
    "Emilia-Romagna"

# `region_province_abbr`

```elixir
@spec region_province_abbr() :: [String.t()]
```

Return a consistent list containing the region and province names with the province code.
Data from https://dait.interno.gov.it/servizi-demografici/documentazione/anagaire-tabelle-comuni-province-consolati-statiterritori

## Examples

    iex> Faker.Address.It.region_province_abbr()
    ["Calabria", "Reggio di Calabria", "RC"]
    iex> Faker.Address.It.region_province_abbr()
    ["Trentino-Alto Adige/Südtirol", "Bolzano/Bozen", "BZ"]
    iex> Faker.Address.It.region_province_abbr()
    ["Puglia", "Bari", "BA"]
    iex> Faker.Address.It.region_province_abbr()
    ["Emilia-Romagna", "Piacenza", "PC"]

# `secondary_address`

```elixir
@spec secondary_address() :: String.t()
```

Return random secondary address.

  ## Examples

    iex> Faker.Address.It.secondary_address()
    "/A"
    iex> Faker.Address.It.secondary_address()
    "/B"
    iex> Faker.Address.It.secondary_address()
    "/A"
    iex> Faker.Address.It.secondary_address()
    "Edificio 26"

# `state`

```elixir
@spec state() :: String.t()
```

Return state. But Italy doesn't have states so this calls Faker.Address.It.region() instead

# `state_abbr`

```elixir
@spec state_abbr() :: String.t()
```

There are no state/region abbreviations in Italy.

# `street_address`

```elixir
@spec street_address() :: String.t()
```

Return street address.

  ## Examples

    iex> Faker.Address.It.street_address()
    "Corso Agave, 2"
    iex> Faker.Address.It.street_address()
    "Viale Keith, 083"
    iex> Faker.Address.It.street_address()
    "Strada per Liguria, 523"
    iex> Faker.Address.It.street_address()
    "Viale De Rosa, 03"

# `street_address`

```elixir
@spec street_address(true | any()) :: String.t()
```

Return `street_address/0` or if argument is `true` adds `secondary_address/0`.

  ## Examples

    iex> Faker.Address.It.street_address(true)
    "Corso Agave, 2/B"
    iex> Faker.Address.It.street_address(false)
    "Via per Piemonte, 832"
    iex> Faker.Address.It.street_address(false)
    "Vicolo Longo, 2"
    iex> Faker.Address.It.street_address(false)
    "Via Privata Galli, 2"

# `street_name`

```elixir
@spec street_name() :: String.t()
```

Return street name.

  ## Examples

    iex> Faker.Address.It.street_name()
    "Corso Agave"
    iex> Faker.Address.It.street_name()
    "Via Privata Gennaro Mazza"
    iex> Faker.Address.It.street_name()
    "Vicolo Shaula Lombardi"
    iex> Faker.Address.It.street_name()
    "Strada per Giuliani"

# `street_prefix`

```elixir
@spec street_prefix() :: String.t()
```

Return street prefix.

  ## Examples

    iex> Faker.Address.It.street_prefix()
    "Vicolo"
    iex> Faker.Address.It.street_prefix()
    "Corso"
    iex> Faker.Address.It.street_prefix()
    "Piazzale"
    iex> Faker.Address.It.street_prefix()
    "Piazza"

# `time_zone`

```elixir
@spec time_zone() :: String.t()
```

Return time zone.

  ## Examples

    iex> Faker.Address.It.time_zone()
    "Australia/Sydney"
    iex> Faker.Address.It.time_zone()
    "America/Guyana"
    iex> Faker.Address.It.time_zone()
    "Asia/Kathmandu"
    iex> Faker.Address.It.time_zone()
    "Europa/Vienna"

# `zip_code`

```elixir
@spec zip_code() :: String.t()
```

Return random postcode.

  ## Examples

    iex> Faker.Address.It.zip_code()
    "01542"
    iex> Faker.Address.It.zip_code()
    "64610"
    iex> Faker.Address.It.zip_code()
    "83297"
    iex> Faker.Address.It.zip_code()
    "05235"

---

*Consult [api-reference.md](api-reference.md) for complete listing*