The globalstats_profile_region method allows you to get all public information about a specific region.

Input parameters:

region_idthe ID of the region
language(optional) EBT language code, defaults to "en" (English); please see the EBT website for a list of available languages
time_offset(optional) offset from UTC in winter time, defaults to 2 (i.e. UTC+2 / EET)

The language and time_offset parameters allow you to localize some data, e.g. show the country name in your language or the timestamp of the region's last activity adjusted to your timezone. By default the data is presented in English and with a Finnish timestamp. Please note that the server is honoring European daylight saving time, so the time offset doesn't have to be adjusted if you're from a country with similar summer time rules.


An associative array containing the following elements:

dataan associative array containing information about the region:
- region_id
- region_namenative name
- region_name_translatedlocalized region name
- country_nameEnglish name
- country_name_translatedlocalized country name
- first_seen_timestamp
- first_seen_timestamp_adjusted
- last_active_timestamp
- last_active_timestamp_adjusted
- latitude
- longitude
- latlong_qualityenumeration: 0 = exact, 1-9 = interpolated at various degrees (higher == worse, >8 may be outright wrong), -1 = no coordinates found;
currently always 3 since we simply average the coordinates of all subsumed locations
- flag_url
- flag_qualityenumeration: 3, 2, 1, 0; level of the region the flag_url actually belongs to; flag_quality >= level, i.e. if no flag is specified for this specific region we return the flag of the parent region, if that doesn't have a flag either the grandparent region, if that's empty the country flag (level 0)
- total_notes
- total_hits
- total_usersnumber of users which set their default location to this region
- total_visitorsnumber of users which entered notes in this region
- levellevel of the administrative layer of the country this region is associated with; enumeration: 1, 2, 3; 1 being the highest level
- subsumed_by_region_iddata of the parent region (NULL if not applicable)
- subsumed_by_region_level
- subsumed_by_region_name
- subsumed_by_region_name_translated
- total_subsumed_region2number of subsumed regions on level 2 (NULL if not applicable)
- region2_name_pluralname of region 2 layer (NULL if not applicable)
- region2_name_plural_translated
- total_subsumed_region3number of subsumed regions on level 3 (NULL if not applicable)
- region3_name_pluralname of region 3 layer (NULL if not applicable)
- region3_name_plural_translated

If there is no region with the requested name the data array is empty.


Current version: 1

Previous versions: -none-

[ back ]