Awesome
</br>
<p align="center"> <a href="https://github.com/antoniojmsjr/IPGeoLocation/blob/master/Image/logo.png"> <img alt="IPGeolocation" height="150" src="https://github.com/antoniojmsjr/IPGeoLocation/blob/master/Image/logo.png"> </a> </p>IPGeoLocation
Biblioteca de geolocalização por IP.
Implementado na linguagem Delphi, utiliza o conceito de fluent interface para guiar no uso da biblioteca.</br> Biblioteca desenvolvida utilizando os principais players do mercado de solução de "IP-Geolocation", em anexo a lista dos provedores homologados.
O que é a geolocalização de IP?
A geolocalização baseada em endereços IP é uma técnica usada para estimar a localização geográfica de um dispositivo conectado à Internet usando o endereço IP do mesmo. Este mecanismo depende de que o endereço IP do dispositivo apareça em um banco de dados com sua respectiva localização, endereço postal, cidade, país, região ou coordenadas geográficas, que são alguns dos níveis de detalhe que podem ser registrados.
Para mais informações: Geolocalização de IPs
Para que?
Essa tecnologia é amplamente usada em:
-
Geo Marketing
- Propagandas direcionadas/sob medida
- Informação interessante com base na localização
- Promoções/campanhas destinadas a certo público/local
- Empresas de turismo, companhias aéreas, redes hoteleiras
- Entretenimento
-
Direcionamento de conteúdo
- Portais “globais” com conteúdos “locais”
- Informações no idioma do leitor
- Conteúdo de interesse local (notícia, novidades, etc)
- Portais de notícias
- Serviços de informação meteorológica
- Serviços de emergência
-
Controle de acesso (à conteúdos/serviços)
- Restringir acesso conteúdo/serviços com base na “localização” do usuário
- Conteúdos específicos para determinado “público”
- Censura
- Jogos online
- Streaming vídeos/músicas
-
Segurança
- Restringir tráfego, por localização do usuário
- Em situação de emergência/ataque descartar tráfego “não esperado”
- Controle de SPAM
- Firewalls
Provedores Homologados
Provedor | Site | API | Free Requests |
---|---|---|---|
IP2Location | https://www.ip2location.com | https://api.ip2location.com/v2 | 10.000 yearthly |
IPGeolocation | https://ipgeolocation.io | https://api.ipgeolocation.io/ipgeo | 1.500 daily |
IPStack | https://ipstack.com | http://api.ipstack.com | 10.000 monthly |
IPIfy | https://geo.ipify.org | https://geo.ipify.org/api/v1 | 1.000 monthly |
IPAPI | https://ipapi.com | http://api.ipapi.com/api | 10.000 yearthly |
IPInfo | https://ipinfo.io | https://ipinfo.io | 50.000 monthly |
IPGeolocationAPI | https://ipgeolocationapi.com | https://api.ipgeolocationapi.com/geolocate | Unlimited |
IPWhois | https://ipwhois.io | http://ipwhois.app | 10.000 monthly |
IPDig | https://ipdig.io | https://ipdig.io | Unlimited |
IPData | https://ipdata.co | https://api.ipdata.co | 1.500 daily |
IPLabstack | https://labstack.com/ip | https://ip.labstack.com/api/v1 | 10.000 monthly |
IPTwist | https://iptwist.com | https://iptwist.com | 1.000 monthly |
IP-API | https://ip-api.com | http://ip-api.com | Unlimited |
DB-IP | https://db-ip.com | http://api.db-ip.com/v2 | Unlimited |
Instalação Automatizada
Utilizando o Boss (Dependency anager for Delphi) é possível instalar a biblioteca de forma automática.
boss install github.com/antoniojmsjr/IPGeoLocation
Instalação Manual:
Project > Options > Delphi Compiler > Target > All Configurations > Search path
..\IPGeoLocation\Source
Uso
uses IPGeoLocation, IPGeoLocation.Interfaces, IPGeoLocation.Types;
var
lMsgError: string;
lGeoLocation: IGeoLocation;
begin
try
lGeoLocation := TIPGeoLocation.New
.IP['201.86.220.241']
.Provider[TIPGeoLocationProviderKind.IPInfo]
//.SetTimeout(5000) //[OPCIONAL]
//.SetAPIKey('TOKEN') //[OPCIONAL]: VERIFICAR ARQUIVO: APIKey.inc
.Request
//.SetResultLanguageCode('pt-br') //[OPCIONAL]
.Execute;
Application.MessageBox(PWideChar(lGeoLocation.ToJSON), 'JSON', MB_OK + MB_ICONINFORMATION); //JSON COM O RESULTADO DA GEOLOCALIZAÇÃO
except
on E: EIPGeoLocationRequestException do
begin
lMsgError := Concat(lMsgError, Format('IP: %s', [E.IP]), sLineBreak);
lMsgError := Concat(lMsgError, Format('IPVersion: %s', [E.IPVersion]), sLineBreak);
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);
end;
on E: Exception do
begin
Application.MessageBox(PWideChar(E.Message), 'A T E N Ç Ã O', MB_OK + MB_ICONERROR);
end;
end;
end;
Demo
Youtube
Licença
IPGeoLocation
is free and open-source software licensed under the