Home

Awesome

Maintained YES Memory Leak Verified YES Release Stars Forks Issues</br> Compatibility Delphi Supported Versions

<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:

Provedores Homologados

ProvedorSiteAPIFree Requests
IP2Locationhttps://www.ip2location.comhttps://api.ip2location.com/v210.000 yearthly
IPGeolocationhttps://ipgeolocation.iohttps://api.ipgeolocation.io/ipgeo1.500 daily
IPStackhttps://ipstack.comhttp://api.ipstack.com10.000 monthly
IPIfyhttps://geo.ipify.orghttps://geo.ipify.org/api/v11.000 monthly
IPAPIhttps://ipapi.comhttp://api.ipapi.com/api10.000 yearthly
IPInfohttps://ipinfo.iohttps://ipinfo.io50.000 monthly
IPGeolocationAPIhttps://ipgeolocationapi.comhttps://api.ipgeolocationapi.com/geolocateUnlimited
IPWhoishttps://ipwhois.iohttp://ipwhois.app10.000 monthly
IPDighttps://ipdig.iohttps://ipdig.ioUnlimited
IPDatahttps://ipdata.cohttps://api.ipdata.co1.500 daily
IPLabstackhttps://labstack.com/iphttps://ip.labstack.com/api/v110.000 monthly
IPTwisthttps://iptwist.comhttps://iptwist.com1.000 monthly
IP-APIhttps://ip-api.comhttp://ip-api.comUnlimited
DB-IPhttps://db-ip.comhttp://api.db-ip.com/v2Unlimited

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

Download IP Geolocalização

Youtube

Vídeo Youtube

Licença

IPGeoLocation is free and open-source software licensed under the License