Web.API.MapQuest

Contents

Description

Synopsis

Geocoding

Running requests

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})

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 #
Instance details Defined in Web.API.MapQuest.Geocoding Methods (==) :: Creds -> Creds -> Bool # (/=) :: Creds -> Creds -> Bool #
Show Creds #
Instance details Defined in Web.API.MapQuest.Geocoding Methods showsPrec :: Int -> Creds -> ShowS # show :: Creds -> String # showList :: [Creds] -> ShowS #

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 #
Instance details Defined in Web.API.MapQuest.Geocoding Methods (==) :: GeoQuery -> GeoQuery -> Bool # (/=) :: GeoQuery -> GeoQuery -> Bool #
Show GeoQuery #
Instance details Defined in Web.API.MapQuest.Geocoding Methods showsPrec :: Int -> GeoQuery -> ShowS # show :: GeoQuery -> String # showList :: [GeoQuery] -> ShowS #

data Coords a #

Coordinates

Constructors

Coords
Fields lat :: a Latitude long :: a Longitude

Instances

Eq a => Eq (Coords a) #
Instance details Defined in Web.API.MapQuest.Geocoding Methods (==) :: Coords a -> Coords a -> Bool # (/=) :: Coords a -> Coords a -> Bool #
Show a => Show (Coords a) #
Instance details Defined in Web.API.MapQuest.Geocoding Methods showsPrec :: Int -> Coords a -> ShowS # show :: Coords a -> String # showList :: [Coords a] -> ShowS #
Generic (Coords a) #
Instance details Defined in Web.API.MapQuest.Geocoding 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) #
Instance details Defined in Web.API.MapQuest.Geocoding type Rep (Coords a) = D1 (MetaData "Coords" "Web.API.MapQuest.Geocoding" "mapquest-api-0.3.1-1mXHHlGJDNE6HMYjVXGBl1" False) (C1 (MetaCons "Coords" PrefixI True) (S1 (MetaSel (Just "lat") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 a) :*: S1 (MetaSel (Just "long") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 a)))