Crate google_geocoding

A strongly-typed (a)synchronous Rusty API for the Google Geocoding API

Synchronous API (Basic)

The synchronous API is optimized for the ergonomics of common usage.

You can do a simple look up of coordinates from an address:

use google_geocoding::geocode;
for coordinates in geocode("1600 Amphitheater Parkway, Mountain View, CA").unwrap() {
    println!("{}", coordinates);
}

Do a simple look up of an address from coordinates:

use google_geocoding::{WGS84, degeocode};
let coordinates = WGS84::try_new(37.42241, -122.08561, 0.0).unwrap();
for address in degeocode(coordinates).unwrap() {
    println!("{}", address);
}

Note that it is recommended to use WGS84::try_new() as WGS84::new() will panic with invalid coordinates

The synchronous API provides the address or coordinates from the API reply. However, the full reply includes a great deal more information. For access to the full reply, see the lowlevel asynchronous API.

Synchronous API (Advanced)

The GeocodeQuery and DegeocodeQuery objects can be used for more complex lookups

use google_geocoding::{GeocodeQuery, Language, Region, geocode};
let query = GeocodeQuery::new("1600 Amphitheater Parkway, Mountain View, CA")
    .language(Language::English)
    .region(Region::UnitedStates);
for coordinates in geocode(query).unwrap() {
    println!("{}", coordinates);
}

Asynchronous API

The Connection object provides access to the lowlevel async-based API.

Unlike the synchronous API, these functions provide the full API reply. You will therefore need to extract the specific information you want.

These functions are used to implement the Synchronous API described earlier.

extern crate google_geocoding;
extern crate tokio_core;

use google_geocoding::Connection;
use tokio_core::reactor::Core;

const ADDRESS: &str = "1600 Amphitheater Parkway, Mountain View, CA";

let mut core = Core::new().unwrap();
let core_handle = core.handle();
let geocode_future = Connection::new(&core_handle).geocode(ADDRESS);
let reply = core.run(geocode_future).unwrap();

for candidate in reply {
    println!("{}: {}", candidate.formatted_address, candidate.geometry.location);
}

Notes

This is an unofficial library.

Official Google Geocoding API

Structs

AddressComponent	One component of a separated address
ApiSet	An API set that deseriaizes as a JSON array and serializes with pipe spaces
Connection	Represents a connection to the Google geocoding API
Coordinates	WGS-84 coordinates that support serializing and deserializing
DegeocodeQuery	A query for an address
FormattedAddress	A human-readable address of this location.
GeocodeQuery	A query for coordinates
Geometry	Position information
LanguageIter
PlaceId	A unique identifier that can be used with other Google APIs. For example, you can use the place_id in a Places SDK request to get details of a local business, such as phone number, opening hours, user reviews, and more. See the place ID overview.
RegionIter
Reply	A reply from the Google geocoding API
Viewport
WGS84	Geodetic position

Enums

ComponentFilterRule	A rule for a component filter
Language	Language that gets serialized as a language code
LocationType	What location Geometry refers to
Place	An address in one of various formats
Region	Country Code Top-Level Domain From https://icannwiki.org/Country_code_top-level_domain
StatusCode	Status codes for the geocode API
Type	The type of an address (eg street, intersection, etc)

Functions

degeocode	Get all the addresses associated with the specified coordinates
geocode	Get all the coordinates associated with the specified filter