NAME

Geo::CEP - Resolve Brazilian city data for a given CEP

VERSION

version 0.2

SYNOPSIS

    use Data::Dumper;
    use Geo::CEP;

    my $gc = new Geo::CEP;
    print Dumper $gc->find("12420-010");

Produz:

    $VAR1 = {
              'state_long' => "S\x{e3}o Paulo",
              'city' => 'Pindamonhangaba',
              'lat' => '-22.9166667',
              'lon' => '-45.4666667',
              'ddd' => '12',
              'state' => 'SP'
            };

DESCRIPTION

Obtém os dados como: nome da cidade, do estado, número DDD e latitude/longitude (da cidade) para um número CEP (Código de Endereçamento Postal) brasileiro.

Diferentemente do WWW::Correios::CEP, consulta os dados armazenados localmente. Por um lado, isso faz Geo::CEP ser extremamente rápido (5 mil consultas por segundo); por outro, somente as informações à nível de cidade são retornadas.

METHODS

find( CEP )

Busca por CEP (no formato 12345678 ou "12345-678") e retorna HashRef com:

• state: sigla da Unidade Federativa (SP, RJ, MG);

• state_long: nome da Unidade Federativa (São Paulo, Rio de Janeiro, Minas Gerais);

• city: nome da cidade;

• ddd: código DDD (pode estar vazio);

• lat/lon: coordenadas geográficas da cidade (podem estar vazias).

Retorna 0 quando não foi possível encontrar.

list()

Retorna HashRef com os dados de todas as cidades.

SEE ALSO

• cep2city

• WWW::Correios::CEP

AUTHOR

Stanislaw Pusep <stas@sysd.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Stanislaw Pusep.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.