An unofficial Google Maps Platform client for the Rust programming language. This client currently implements the Directions API, Distance Matrix API, Elevation API, Geocoding API, and Time Zone API.
This crate is expected to work well and have the more important Google Maps features implemented. It should work well because Reqwest and Serde do most of the heavy lifting! While it's an early release, this crate should work fine as is for most people.
I created this library because I needed several Google Maps Platform features for a project that I'm working on. So, I've decided to spin my library off into a public crate. This is a very small token of gratitude and an attempt to give back to the Rust community. I hope it saves someone out there some work.
```rust use google_maps::*;
let directions = DirectionsRequest::new( YOURGOOGLEAPIKEYHERE, // Canadian Museum of Nature Location::Address(String::from("240 McLeod St, Ottawa, ON K2P 2R1")), // Canada Science and Technology Museum Location::LatLng { lat: 45.403509, lng: -75.618904 }, ) .withtravelmode(TravelMode::Transit) .witharrivaltime(PrimitiveDateTime::new( Date::tryfromymd(2020, 1, 20).unwrap(), Time::tryfromhms(13, 00, 0).unwrap() )) .execute().unwrap();
println!("{:#?}", directions); ```
```rust use google_maps::*;
// Example request:
let distancematrix = DistanceMatrixRequest::new( YOURGOOGLEAPIKEY_HERE, // Origins vec![ // Microsoft Waypoint::Address(String::from("One Microsoft Way, Redmond, WA 98052, United States")), // Apple Waypoint::Address(String::from("Infinite Loop, Cupertino, CA 95014, United States")), ], // Destinations vec![ // Google Waypoint::PlaceId(String::from("ChIJj61dQgK6j4AR4GeTYWZsKWw")), // Mozilla Waypoint::LatLng { lat: 37.387316, lng: -122.060008 }, ], ).execute().unwrap();
// Dump entire response:
println!("{:#?}", distance_matrix); ```
```rust use google_maps::*;
// Example request:
let elevation = ElevationRequest::new(YOURGOOGLEAPIKEYHERE) .positional_request(ElevationLocations::LatLngs(vec![ // Denver, Colorado, the "Mile High City" LatLng { lat: 39.7391536, lng: -104.9847034 }, ])) .execute().unwrap();
// Dump entire response:
println!("{:#?}", elevation);
// Parsing example:
println!("Elevation: {} meters", elevation.results.unwrap()[0].elevation); ```
```rust use google_maps::*;
// Example request:
let location = GeocodingRequest::new(YOURGOOGLEAPIKEYHERE) .with_address("10 Downing Street London") .execute().unwrap();
// Dump entire response:
println!("{:#?}", location);
// Parsing example:
for result in &location.results { println!( "Latitude: {:.7}, Longitude: {:.7}", result.geometry.location.lat, result.geometry.location.lng ); } ```
```rust use google_maps::*;
// Example request:
let location = GeocodingReverseRequest::new( YOURGOOGLEAPIKEYHERE, // 10 Downing St, Westminster, London LatLng { lat: 51.5033635, lng: -0.1276248 } ) .withresulttype(PlaceType::StreetAddress) .execute().unwrap();
// Dump entire response:
println!("{:#?}", location);
// Parsing example:
for result in &location.results { for addresscomponent in &result.addresscomponents { print!("{} ", addresscomponent.shortname); } println!(""); // New line. } ```
```rust use google_maps::*;
// Example request:
let timezone = TimeZoneRequest::new( YOURGOOGLEAPIKEYHERE, // St. Vitus Cathedral in Prague, Czechia LatLng { lat: 50.090903, lng: 14.400512 }, PrimitiveDateTime::new( // Tuesday February 15, 2022 Date::tryfromymd(2022, 2, 15).unwrap(), // 6:00:00 pm Time::tryfrom_hms(18, 00, 0).unwrap(), ), ).execute().unwrap();
// Dump entire response:
println!("{:#?}", time_zone);
// Parsing example:
use std::time::{SystemTime, UNIX_EPOCH};
let unixtimestamp = SystemTime::now().durationsince(UNIXEPOCH).unwrap().assecs();
println!("Time at your computer: {}", unix_timestamp);
println!("Time in {}: {}", timezone.timezoneid.unwrap(), unixtimestamp as i64 + timezone.dstoffset.unwrap() as i64 + timezone.rawoffset.unwrap() as i64 ); ```