BuscaCEP ist eine Bibliothek zur Abfrage von Online-Adressen, die eine Suche nach CEP (Postal Address Code) oder nach Straße (UF, Ort und Straße) ermöglicht.
BuscaCEP ist in der Delphi
-Sprache implementiert und nutzt das Konzept einer fließenden Schnittstelle, um die Nutzung der Bibliothek zu steuern. Sie wurde entwickelt, um Praktikabilität und Effizienz zu bieten. BuscaCEP integriert die Hauptakteure auf dem Markt: Correios, ViaCEP, BrasilAPI und andere.
Diese Bibliothek ist ideal für Delphi-Entwickler, die eine robuste, flexible und effiziente Lösung zur Integration von Online-Adressabfragen in ihre Anwendungen suchen.
Mit Boss (Abhängigkeitsmanager für Delphi) ist es möglich, die Bibliothek automatisiert zu installieren.
boss install https://github.com/antoniojmsjr/BuscaCEP
Wenn Sie sich für eine manuelle Installation entscheiden, fügen Sie einfach die folgenden Ordner zu Ihrem Projekt hinzu, unter Projekt > Optionen > Delphi-Compiler > Ziel > Alle Konfigurationen > Suchpfad
.. BuscaCEP Source
Anbieter | Verwenden Sie APIKey? | Nach Postleitzahl suchen? | * Nach öffentlichem Ort suchen? |
---|---|---|---|
Post | NEIN | JA | JA |
Über CEP | NEIN | JA | JA |
Brasilien-API | NEIN | JA | NEIN |
Öffnen Sie CEP | JA | JA | JA |
Virtuelle Republik | NEIN | JA | NEIN |
Richtige Postleitzahl | NEIN | JA | JA |
KingHost | JA | JA | NEIN |
Postmon | NEIN | JA | NEIN |
Kostenloses CEP | JA | JA | JA |
Öffnen Sie CEP | JA | JA | JA |
CEP-API | JA | JA | JA |
Brasilien Open | JA | JA | JA |
AwesomeAPI | NEIN | JA | NEIN |
* Für die Abfrage anhand der Straßenadresse sind drei obligatorische Parameter erforderlich: Bundesland, Stadt und Straße .
Um den IBGE-Code und DDD-Code für den Standort bei der Rückgabe der Abfrage bereitzustellen, wurde die BuscaCEP -.dat- Datei erstellt, die auf der IBGE-Standort-API und den von Anatel bereitgestellten Daten basiert.
Beispiele finden Sie im Projektordner:
.. BuscaCEP Samples
Abfrage nach Postleitzahl
uses
BuscaCEP , BuscaCEP .Types, BuscaCEP .Interfaces, System.SysUtils;
var
l BuscaCEP Response: I BuscaCEP Response;
lMsgError: string;
begin
try
l BuscaCEP Response := T BuscaCEP .New
// .SetArquivoCache() [OPCIONAL]
.Providers[T BuscaCEP ProvidersKind.Correios]
// .SetAPIKey() [CONFORME O PROVEDOR]
.Filtro
.SetCEP( ' 90520-003 ' )
.Request
// .SetTimeout() [OPCIONAL]
.Execute;
except
on E: E BuscaCEP Request do
begin
lMsgError := Concat(lMsgError, Format( ' Provider: %s ' , [E.Provider]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' DateTime: %s ' , [DateTimeTostr(E.DateTime)]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Kind: %s ' , [E.Kind.AsString]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' URL: %s ' , [E.URL]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Method: %s ' , [E.Method]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Status Code: %d ' , [E.StatusCode]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Status Text: %s ' , [E.StatusText]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Message: %s ' , [E.Message]));
Application.MessageBox(PWideChar(lMsgError), ' A T E N Ç Ã O ' , MB_OK + MB_ICONERROR);
Exit;
end ;
on E: Exception do
begin
Application.MessageBox(PWideChar(E.Message), ' A T E N Ç Ã O ' , MB_OK + MB_ICONERROR);
Exit;
end ;
end ;
end ;
Beratung durch Street
uses
BuscaCEP , BuscaCEP .Types, BuscaCEP .Interfaces, System.SysUtils;
var
l BuscaCEP Response: I BuscaCEP Response;
lMsgError: string;
begin
try
l BuscaCEP Response := T BuscaCEP .New
// .SetArquivoCache() [OPCIONAL]
.Providers[T BuscaCEP ProvidersKind.Correios]
// .SetAPIKey() [CONFORME O PROVEDOR]
.Filtro
.SetLogradouro( ' Avenida Plínio Brasil Milano ' )
.SetLocalidade( ' Porto Alegre ' )
.SetUF( ' RS ' )
.& End
.Request
// .SetTimeout() [OPCIONAL]
.Execute;
except
on E: E BuscaCEP Request do
begin
lMsgError := Concat(lMsgError, Format( ' Provider: %s ' , [E.Provider]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' DateTime: %s ' , [DateTimeTostr(E.DateTime)]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Kind: %s ' , [E.Kind.AsString]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' URL: %s ' , [E.URL]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Method: %s ' , [E.Method]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Status Code: %d ' , [E.StatusCode]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Status Text: %s ' , [E.StatusText]), sLineBreak);
lMsgError := Concat(lMsgError, Format( ' Message: %s ' , [E.Message]));
Application.MessageBox(PWideChar(lMsgError), ' A T E N Ç Ã O ' , MB_OK + MB_ICONERROR);
Exit;
end ;
on E: Exception do
begin
Application.MessageBox(PWideChar(E.Message), ' A T E N Ç Ã O ' , MB_OK + MB_ICONERROR);
Exit;
end ;
end ;
end ;
Abfrageergebnis [I BuscaCEP -Antwort]
uses
BuscaCEP .Types, BuscaCEP .Interfaces;
var
l BuscaCEP Response: I BuscaCEP Response;
l BuscaCEP Logradouro: T BuscaCEP Logradouro;
begin
for l BuscaCEP Logradouro in l BuscaCEP Response.Logradouros do
begin
l BuscaCEP Logradouro.Logradouro;
l BuscaCEP Logradouro.Complemento;
l BuscaCEP Logradouro.Unidade;
l BuscaCEP Logradouro.Bairro;
l BuscaCEP Logradouro.Localidade.Nome;
l BuscaCEP Logradouro.Localidade.IBGE;
l BuscaCEP Logradouro.Localidade.DDD;
l BuscaCEP Logradouro.Localidade.Estado.Nome;
l BuscaCEP Logradouro.Localidade.Estado.IBGE;
l BuscaCEP Logradouro.Localidade.Estado.Sigla;
l BuscaCEP Logradouro.Localidade.Estado.Regiao.Nome;
l BuscaCEP Logradouro.Localidade.Estado.Regiao.IBGE;
l BuscaCEP Logradouro.Localidade.Estado.Regiao.Sigla;
l BuscaCEP Logradouro.CEP;
end ;
Abfrageergebnis [JSON]
{
"provider" : " #CORREIOS " ,
"date_time" : " 2024-05-01T02:35:14.772-03:00 " ,
"request_time" : " 75ms " ,
"total" : 1 ,
"logradouros" : [
{
"logradouro" : " Avenida Plínio Brasil Milano " ,
"complemento" : " de 1947 ao fim - lado ímpar " ,
"unidade" : " " ,
"bairro" : " Passo da Areia " ,
"cep" : " 90520003 " ,
"localidade" : {
"ibge" : 4314902 ,
"ddd" : 51 ,
"nome" : " Porto Alegre " ,
"estado" : {
"ibge" : 43 ,
"nome" : " Rio Grande do Sul " ,
"sigla" : " RS " ,
"regiao" : {
"ibge" : 4 ,
"nome" : " Sul " ,
"sigla" : " S "
}
}
}
}
]
}
Herunterladen: Demos.zip
BuscaCEP
ist eine kostenlose Open-Source-Software, die unter der Lizenz steht