com.ip2location

Class IP2LocationWebService

java.lang.Object

com.ip2location.IP2LocationWebService

public class IP2LocationWebService
extends Object

This class performs the lookup of IP2Location data from an IP address by querying the IP2Location Web Service.

Example usage scenarios:

• Redirect based on country
• Digital rights management
• Web log stats and analysis
• Auto-selection of country on forms
• Filter access from countries you do not do business with
• Geo-targeting for increased sales and click-through
• And much, much more!

Requirements: Java SDK 1.4 or later

Copyright (c) 2002-2020 IP2Location.com

Version:

8.5.0

Author:

IP2Location.com

Constructor Summary

Constructors

Constructor and Description
IP2LocationWebService()

Method Summary

Methods

Modifier and Type	Method and Description
com.google.gson.JsonObject	GetCredit() This function to check web service credit balance.
com.google.gson.JsonObject	IPQuery(String IPAddress) This function to query IP2Location data.
com.google.gson.JsonObject	IPQuery(String IPAddress, String Language) This function to query IP2Location data.
com.google.gson.JsonObject	IPQuery(String IPAddress, String[] AddOns, String Language) This function to query IP2Location data.
void	Open(String APIKey, String Package) This function initializes the params for the web service.
void	Open(String APIKey, String Package, boolean UseSSL) This function initializes the params for the web service.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IP2LocationWebService

public IP2LocationWebService()

Method Detail

Open

public void Open(String APIKey,
        String Package)
          throws IllegalArgumentException

This function initializes the params for the web service.

Throws:

IllegalArgumentException

Open

public void Open(String APIKey,
        String Package,
        boolean UseSSL)
          throws IllegalArgumentException

This function initializes the params for the web service.

Throws:

IllegalArgumentException

IPQuery

public com.google.gson.JsonObject IPQuery(String IPAddress)
                                   throws IllegalArgumentException,
                                          RuntimeException

This function to query IP2Location data.

Parameters:

IPAddress - IP Address you wish to query

Returns:

IP2Location data

Throws:

IllegalArgumentException

RuntimeException

IPQuery

public com.google.gson.JsonObject IPQuery(String IPAddress,
                                 String Language)
                                   throws IllegalArgumentException,
                                          RuntimeException

This function to query IP2Location data.

Parameters:

IPAddress - IP Address you wish to query and translation language

Returns:

IP2Location data

Throws:

IllegalArgumentException

RuntimeException

IPQuery

public com.google.gson.JsonObject IPQuery(String IPAddress,
                                 String[] AddOns,
                                 String Language)
                                   throws IllegalArgumentException,
                                          RuntimeException

This function to query IP2Location data.

Parameters:

IPAddress - IP Address you wish to query, Addons and translation language

Returns:

IP2Location data

Throws:

IllegalArgumentException

RuntimeException

GetCredit

public com.google.gson.JsonObject GetCredit()
                                     throws IllegalArgumentException,
                                            RuntimeException

This function to check web service credit balance.

Returns:

Credit balance

Throws:

IllegalArgumentException

RuntimeException