15 releases

0.3.6 Nov 9, 2023
0.3.5 Mar 27, 2021
0.3.3 Feb 24, 2021
0.3.0 Jan 21, 2021
0.2.6 Nov 25, 2020

#1000 in Network programming

Download history 35/week @ 2023-12-07 51/week @ 2023-12-14 34/week @ 2023-12-21 38/week @ 2023-12-28 76/week @ 2024-01-04 64/week @ 2024-01-11 85/week @ 2024-01-18 151/week @ 2024-01-25 77/week @ 2024-02-01 89/week @ 2024-02-08 83/week @ 2024-02-15 108/week @ 2024-02-22 97/week @ 2024-02-29 102/week @ 2024-03-07 82/week @ 2024-03-14 47/week @ 2024-03-21

355 downloads per month
Used in 4 crates

GPL-3.0 license

26KB
447 lines

ipgeolocate

Crates.io API Crates.io

Get IP address geolocation information freely.

ipgeolocate = "0.3.5"

Add to Cargo.toml.

Example

Because ipgeolocate is an async library, you need an async runtime like tokio or async-std to run.

Using ipgeolocate is really quite easy:

use ipgeolocate::{Locator, Service};

// Prints the city where 1.1.1.1 is.
#[tokio::main]
async fn main() {
    let service = Service::IpApi;
    let ip = "1.1.1.1";

    match Locator::get(ip, service).await {
        Ok(ip) => println!("{} - {} ({})", ip.ip, ip.city, ip.country),
        Err(error) => println!("Error: {}", error),
    };
}

This and more examples are found in the examples directory.

Query Limits

Each service included in this library has a weekly, hourly, or monthly limit. Some have more free queries, but are less reliable.

Here are the query limits:

Service Limit
ipwhois.app 10,000/month
freegeoip.app 15,000/hour
ip-api.com 45/minute
ipapi.co 1,000/day (30,000/month)

You can use each of these just by running the function of the same name.

freegeoip.app is not recommended because it has issues reliably getting the correct latitude and longitude for IP addresses.

Fields

The API can get these fields about IP addresses.

  • ip
  • latitude
  • longitude
  • city
  • region
  • country
  • timezone

Credits

Grant Handy grantshandy@gmail.com

APIs included:

Written with love, in Rust.

Dependencies

~5–18MB
~257K SLoC