Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Resolve Brazilian city data for a given CEP
Perl
Tag: v0.1

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
inc
lib
share
t
.gitignore
Changes
README.pod
dist.ini
weaver.ini

README.pod

NAME

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

VERSION

version 0.1

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

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.

Something went wrong with that request. Please try again.