NAME Geo::CEP - Resolve Brazilian city data for a given CEP VERSION version 1.0 SYNOPSIS use common::sense; use utf8::all; use Data::Printer; # 'memoize' Г© extremamente vantajoso em casos aonde a mesma # instГўncia Г© utilizada para resolver lotes grandes de CEPs use Geo::CEP qw(memoize); my $gc = Geo::CEP->new; p $gc->find("12420-010"); # SaГda: # \ { # cep_final 12449999 # cep_initial 12400000 # city "Pindamonhangaba", # ddd 12, # lat -22.9166667, # lon -45.4666667, # state "SP", # state_long "SГЈo Paulo" # } 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. ATTRIBUTES data, index FileHandle para os respectivos arquivos. length Tamanho do Гndice. states Mapeamento de cГіdigo de estado para o nome do estado (AC => 'Acre'). idx_len Tamanho do registro de Гndice. METHODS find($cep) Busca por $cep (no formato 12345678 ou "12345-678") e retorna HashRef com: * cep_initial: o inГcio da faixa de CEPs da cidade; * cep_final: o tГ©rmino da faixa de CEP da cidade; * 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 undef quando nГЈo foi possГvel encontrar. list() Retorna HashRef com os dados de todas as cidades. SEE ALSO * cep2city * Business::BR::CEP * WWW::Correios::CEP * WWW::Correios::PrecoPrazo * WWW::Correios::SRO CONTRIBUTORS * Blabos de Blebe <https://metacpan.org/author/BLABOS> AUTHOR Stanislaw Pusep <stas@sysd.org> COPYRIGHT AND LICENSE This software is copyright (c) 2014 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.