Quickstart

Requirements

Intellij IDEA: https://www.jetbrains.com/idea/

Installation

IP2Location.io Kotlin: https://central.sonatype.com/artifact/com.ip2location/ip2location-io-kotlin

Sample Codes

Lookup IP Address Geolocation Data

package org.example

import com.google.gson.JsonObject
import com.ip2location.Configuration
import com.ip2location.IPGeolocation
import kotlinx.coroutines.runBlocking

fun main() {
    try {
        // Configures IP2Location.io API key
        val config = Configuration()
        val apiKey = "YOUR_API_KEY"
        config.apiKey = apiKey
        val ipl = IPGeolocation(config)

        // Lookup ip address geolocation data
        val myObj: JsonObject = runBlocking {
            ipl.lookup(
                "8.8.8.8", "en"
            )
        } // the language parameter is only available for Plus and Security plans

        println(myObj)
    } catch (e: Exception) {
        println(e)
        //e.printStackTrace(System.out)
        throw e
    }
}

Lookup Domain Information

package org.example

import com.google.gson.JsonObject
import com.ip2location.Configuration
import com.ip2location.DomainWhois
import kotlinx.coroutines.runBlocking

fun main() {
    try {
        // Configures IP2Location.io API key
        val config = Configuration()
        val apiKey = "YOUR_API_KEY"
        config.apiKey = apiKey
        val whois = DomainWhois(config)

        // Lookup domain information
        val myObj: JsonObject = runBlocking { whois.lookup("locaproxy.com") }
        println(myObj)
    } catch (e: Exception) {
        println(e)
        //e.printStackTrace(System.out)
        throw e
    }
}

Convert Normal Text to Punycode

package org.example

import com.ip2location.Configuration
import com.ip2location.DomainWhois

fun main() {
    try {
        val whois = DomainWhois(Configuration())

        // Convert normal text to punycode
        println(whois.toPunycode("täst.de"))
    } catch (e: Exception) {
        println(e)
        //e.printStackTrace(System.out)
        throw e
    }
}

Convert Punycode to Normal Text

package org.example

import com.ip2location.Configuration
import com.ip2location.DomainWhois

fun main() {
    try {
        val whois = DomainWhois(Configuration())

        // Convert punycode to normal text
        println(whois.toNormalText("xn--tst-qla.de"))
    } catch (e: Exception) {
        println(e)
        //e.printStackTrace(System.out)
        throw e
    }
}

Get Domain Name

package org.example

import com.ip2location.Configuration
import com.ip2location.DomainWhois

fun main() {
    try {
        val whois = DomainWhois(Configuration())

        // Get domain name from URL
        println(whois.toDomainName("https://www.example.com/exe"))
    } catch (e: Exception) {
        println(e)
        //e.printStackTrace(System.out)
        throw e
    }
}

Get Domain Extension

package org.example

import com.ip2location.Configuration
import com.ip2location.DomainWhois

fun main() {
    try {
        val whois = DomainWhois(Configuration())

        // Get domain extension (gTLD or ccTLD) from URL or domain name
        println(whois.toDomainExtension("example.com"))
    } catch (e: Exception) {
        println(e)
        //e.printStackTrace(System.out)
        throw e
    }
}

Lookup IP Address Hosted Domains Data

package org.example

import com.google.gson.JsonObject
import com.ip2location.Configuration
import com.ip2location.HostedDomain
import kotlinx.coroutines.runBlocking

fun main() {
    try {
        // Configures IP2Location.io API key
        val config = Configuration()
        val apiKey = "YOUR_API_KEY"
        config.apiKey = apiKey
        val hd = HostedDomain(config)

        // Lookup ip address hosted domains data
        val myObj: JsonObject = runBlocking {
            hd.lookup(
                "8.8.8.8", 1
            )
        }

        println(myObj)
    } catch (e: Exception) {
        println(e)
        //e.printStackTrace(System.out)
        throw e
    }
}