Web.API.MapQuest

Geocoding

Running requests

runRequest

Arguments

:: (FromJSON a, Floating a)

=> Creds

API key (available for free on https://developer.mapquest.com)

-> GeoQuery

Location to be queried

-> IO (Maybe (Coords a))

Call the MapQuest Geocoding API with a given address and extract the coordinates from the parsed result.

Example usage : assuming the user has bound key to hold the API key string, the following can be run in a GHCi shell :

>>> runRequest key (GQ "Via Irnerio" "Bologna" "Italy")
Just (Coords {lat = 44.49897, long = 11.34503})

>>> runRequest key (GQFree "Ngong Ping 360, Hong Kong")
Just (Coords {lat = 22.264412, long = 114.16706})

Parameters

newtype Creds

The user's API credential (i.e. the MapQuest "consumer key", visible at https://developer.mapquest.com/user/me/apps )

Constructors

Creds

Fields

• apiKey :: Text

Instances

Eq Creds

Methods

(==) :: Creds -> Creds -> Bool

(/=) :: Creds -> Creds -> Bool

Show Creds

Methods

showsPrec :: Int -> Creds -> ShowS

show :: Creds -> String

showList :: [Creds] -> ShowS

data GeoQuery

Geocoding query parameters

Constructors

GQ

Fields

• gqStreet :: Text

  Street address (e.g. "Via Irnerio")

• gqCity :: Text

  City (e.g. "Bologna")

• gqCountry :: Text

  Country (e.g. "Italy")

GQFree Text

Free-text query (must be a valid address or location e.g. "Ngong Ping 360, Hong Kong")

Instances

Eq GeoQuery

Methods

(==) :: GeoQuery -> GeoQuery -> Bool

(/=) :: GeoQuery -> GeoQuery -> Bool

Show GeoQuery

Methods

showsPrec :: Int -> GeoQuery -> ShowS

show :: GeoQuery -> String

showList :: [GeoQuery] -> ShowS

Output

data Coords a

Coordinates

Constructors

Coords

Fields

• lat :: a

  Latitude

• long :: a

  Longitude

Instances

Eq a => Eq (Coords a)

Methods

(==) :: Coords a -> Coords a -> Bool

(/=) :: Coords a -> Coords a -> Bool

Show a => Show (Coords a)

Methods

showsPrec :: Int -> Coords a -> ShowS

show :: Coords a -> String

showList :: [Coords a] -> ShowS

Generic (Coords a)

Associated Types

type Rep (Coords a) :: * -> *

Methods

from :: Coords a -> Rep (Coords a) x

to :: Rep (Coords a) x -> Coords a

type Rep (Coords a)

type Rep (Coords a) = D1 * (MetaData "Coords" "Web.API.MapQuest.Geocoding" "mapquest-api-0.3.1-54kM5aQ6JQq4hxpDXL9gn5" False) (C1 * (MetaCons "Coords" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "lat") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 * a)) (S1 * (MetaSel (Just Symbol "long") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 * a))))