geoip_region_name_by_code

(PECL geoip >= 1.0.4)

geoip_region_name_by_code — Retorna o nome da região para alguma combinação de código de país e região

Descrição

geoip_region_name_by_code(string $country_code, string $region_code): string

A função geoip_region_name_by_code() retornará o nome da região correspondente a uma combinação de código de país e região.

Nos Estados Unidos, o código de região corresponde à abreviação de duas letras de cada estado. No Canadá, o código de região corresponde ao código de duas letras da província ou território, conforme atribuído pelo Canada Post.

Para o resto do mundo, o GeoIP usa códigos FIPS 10-4 para representar regiões. Pode-se verificar » http://www.maxmind.com/app/fips10_4 para uma lista detalhada de códigos FIPS 10-4.

Esta função está sempre disponível se estiver usando a versão 1.4.1 ou mais recente da biblioteca GeoIP. Os dados são retirados diretamente da biblioteca GeoIP e não de qualquer banco de dados.

Parâmetros

country_code: O código de país de duas letras (consulte geoip_country_code_by_name())
region_code: O código de região de duas letras (ou dígitos) (consulte geoip_region_by_name())

Valor Retornado

Retorna o nome da região em caso de sucesso, ou false se a combinação de código de país e região não puder ser encontrada.

Exemplos

Exemplo #1 Um exemplo de geoip_region_name_by_code() usando código de região para o Canadá

Isso exibirá o nome da região para o país CA (Canadá) e região QC (Quebec).

<?php
$region = geoip_region_name_by_code('CA', 'QC');
if ($region) {
    echo 'O nome da região para CA/QC é: ' . $region;
}
?>

O exemplo acima produzirá:

O nome da região para CA/QC é: Quebec

Exemplo #2 Um exemplo de geoip_region_name_by_code() usando códigos FIPS

Isso imprimirá o nome da região do país JP (Japão), região 01.

<?php
$region = geoip_region_name_by_code('JP', '01');
if ($region) {
    echo 'O nome da região para JP/01 é: ' . $region;
}
?>

O exemplo acima produzirá:

O nome da região para JP/01 é: Aichi