freesmartphone.org Data World Interface

Description

The World interface is used to query (more or less static) information about the communication world, such as countries and their timezones, mobile broadband provider apns, etc.

Namespace

org.freesmartphone.Data.World

Methods

Signals

None

Properties

None

Errors

None

Methods

GetAllCountries ( ) → a(ss)

Description: Retrieves all known country codes and their (english) name.

Returns:

a(ss): countries A list of country codes and their (english) names.

GetCountryCodeForMccMnc ( s ) → s

Description: Retrieve a country code for MCC or concatenated MCC and MNC. Raises InvalidParameter if not found.

Parameters:*

s: mcc_mnc MCC or concatenated MCC and MNC.

Returns:

s: country_code The country code that owns the specified MCC (and MNC).

GetTimezonesForCountryCode ( s ) → a{ss}

Description: Retrieves the list of timezones given a country code. Raises InvalidParameter if not found.

Parameters:*

s: country_code The country code.

Returns:

a{ss}: timezones A dictionary of coordinates and timezone names.

GetApnsForMccMnc ( s ) → a(ssssss)

Description: Retrieves a list of data connectivity (GPRS, EDGE, 3G) access point names for MCC or concatenated MCC and MNC. Raises InvalidParameter if not found.

Parameters:*

s: mcc_mnc MCC or concatenated MCC and MNC.

Returns:

a(ssssss): apns A list of six-tuples descriping a connectivity access point. Structure is:

GetProviderNameForMccMnc ( s ) → s

Description: Retrieves the name of a provider for a supplied concatenated MCC and MNC. Raises InvalidParameter if not found.

Parameters:*

s: mcc_mnc MCC or concatenated MCC and MNC.

Returns:

s: provider Name of the provider.