bigdatacloud 1.0.0

Official Rust SDK for BigDataCloud APIs — IP Geolocation, Reverse Geocoding, Phone & Email Verification, Network Engineering
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

use std::collections::HashMap;
use crate::http_client::HttpClient;
use crate::error::Result;
use crate::models::{ReverseGeocodeResponse, ReverseGeocodeWithTimezoneResponse, TimezoneResponse};

/// Reverse Geocoding package — 3 endpoints.
#[derive(Clone)]
pub struct ReverseGeocodingApi {
    http: HttpClient,
}

impl ReverseGeocodingApi {
    pub fn new(http: HttpClient) -> Self { Self { http } }

    /// Converts GPS coordinates to city, locality, subdivision, and country.
    pub fn reverse_geocode(&self, latitude: f64, longitude: f64, locality_language: &str) -> Result<ReverseGeocodeResponse> {
        self.http.get("reverse-geocode", latlon(latitude, longitude, locality_language))
    }

    /// Converts GPS coordinates to locality and timezone in a single call.
    pub fn reverse_geocode_with_timezone(&self, latitude: f64, longitude: f64, locality_language: &str) -> Result<ReverseGeocodeWithTimezoneResponse> {
        self.http.get("reverse-geocode-with-timezone", latlon(latitude, longitude, locality_language))
    }

    /// Returns timezone information for GPS coordinates.
    pub fn get_timezone_by_location(&self, latitude: f64, longitude: f64) -> Result<TimezoneResponse> {
        let mut p = HashMap::new();
        p.insert("latitude".to_string(), latitude.to_string());
        p.insert("longitude".to_string(), longitude.to_string());
        self.http.get("timezone-by-location", p)
    }
}

fn latlon(lat: f64, lon: f64, lang: &str) -> HashMap<String, String> {
    let mut p = HashMap::new();
    p.insert("latitude".to_string(), lat.to_string());
    p.insert("longitude".to_string(), lon.to_string());
    p.insert("localityLanguage".to_string(), lang.to_string());
    p
}