View Source Appwrite.Services.Locale (appwrite v0.1.5)

The Locale service allows you to customize your app based on your users' location. Using this service, you can get your users' location, IP address, list of countries and continents names, phone codes, currencies, and more.

The user service supports multiple locales. This feature allows you to fetch countries and continents information in your app language.

Status: In Testing

Summary

Functions

Get user locale.

List locale codes.

List continents.

List countries.

List EU countries.

List phone codes.

List currencies.

List languages.

Functions

Get user locale.

Retrieves the current user's location based on their IP. Returns an object containing country code, country name, continent name, continent code, IP address, and suggested currency.

Examples

iex> Appwrite.Locale.get(client)
{:ok, %Appwrite.Types.Locale{}}

Params

  • client (required): The Appwrite client instance.

Returns

  • {:ok, %Appwrite.Types.Locale{}} on success.
  • {:error, %Appwrite.Exceptions.AppwriteException{}} on failure.

List locale codes.

Fetches all locale codes classified by ISO 639-1.

Examples

iex> Appwrite.Locale.list_codes(client)
{:ok, %Appwrite.Types.LocaleCodeList{}}

Params

  • client (required): The Appwrite client instance.

Returns

  • {:ok, %Appwrite.Types.LocaleCodeList{}} on success.
  • {:error, %Appwrite.Exceptions.AppwriteException{}} on failure.

List continents.

Fetches a list of all continents.

Examples

iex> Appwrite.Locale.list_continents(client)
{:ok, %Appwrite.Types.ContinentList{}}

Params

  • client (required): The Appwrite client instance.

Returns

  • {:ok, %Appwrite.Types.ContinentList{}} on success.
  • {:error, %Appwrite.Exceptions.AppwriteException{}} on failure.

List countries.

Fetches a list of all countries.

Examples

iex> Appwrite.Locale.list_countries(client)
{:ok, %Appwrite.Types.CountryList{}}

Params

  • client (required): The Appwrite client instance.

Returns

  • {:ok, %Appwrite.Types.CountryList{}} on success.
  • {:error, %Appwrite.Exceptions.AppwriteException{}} on failure.
Link to this function

list_countries_eu(client)

View Source

List EU countries.

Fetches a list of all countries in the European Union.

Examples

iex> Appwrite.Locale.list_countries_eu(client)
{:ok, %Appwrite.Types.CountryList{}}

Params

  • client (required): The Appwrite client instance.

Returns

  • {:ok, %Appwrite.Types.CountryList{}} on success.
  • {:error, %Appwrite.Exceptions.AppwriteException{}} on failure.
Link to this function

list_countries_phones(client)

View Source
@spec list_countries_phones(Appwrite.Helpers.Client.t()) ::
  {:ok, Appwrite.Types.PhoneList.t()}
  | {:error, Appwrite.Exceptions.AppwriteException.t()}

List phone codes.

Fetches a list of all countries' phone codes.

Examples

iex> Appwrite.Locale.list_countries_phones(client)
{:ok, %Appwrite.Types.PhoneList{}}

Params

  • client (required): The Appwrite client instance.

Returns

  • {:ok, %Appwrite.Types.PhoneList{}} on success.
  • {:error, %Appwrite.Exceptions.AppwriteException{}} on failure.

List currencies.

Fetches a list of all currencies.

Examples

iex> Appwrite.Locale.list_currencies(client)
{:ok, %Appwrite.Types.CurrencyList{}}

Params

  • client (required): The Appwrite client instance.

Returns

  • {:ok, %Appwrite.Types.CurrencyList{}} on success.
  • {:error, %Appwrite.Exceptions.AppwriteException{}} on failure.

List languages.

Fetches a list of all languages classified by ISO 639-1.

Examples

iex> Appwrite.Locale.list_languages(client)
{:ok, %Appwrite.Types.LanguageList{}}

Params

  • client (required): The Appwrite client instance.

Returns

  • {:ok, %Appwrite.Types.LanguageList{}} on success.
  • {:error, %Appwrite.Exceptions.AppwriteException{}} on failure.