1. Home
2. Reference documentation
3. VCL Reference
4. Variables
5. Geolocation

client.geo.region.ascii

STRING, read-only.

Available in all subroutines.

ISO 3166-2 country subdivision code. For countries with multiple levels of subdivision (for example, nations within the United Kingdom), this variable gives the more specific subdivision.

The special value NO REGION is given for countries that do not have ISO country subdivision codes. For example, NO REGION is given for IP addresses assigned to the Åland Islands (country code AX, illustrated below).

These region values are the subdivision part only. For typical use, a subdivision is normally formatted with its associated country code. The following subroutine illustrates constructing an ISO 3166-2 two-part country and subdivision code from the respective variables:

sub client_geo_code STRING {
  declare local var.code STRING;

  if (client.geo.country_code != "**") {
    set var.code = client.geo.country_code;
    if (client.geo.region != "NO REGION" && client.geo.region != "?") {
      set var.code = var.code + "-" + client.geo.region;
    }
  }

  return var.code;
}

Examples

Here are some example values:

Here, the region name is given for sake of reference only. The region name is not provided as a VCL variable.