Beer Mapping API Reference | The Beer Mapping Project

Here we have the urls of the Beer Mapping API referenced and we have comments on the request parameters and comments on the types of responses you should expect when using these urls.

You can check out examples of code using the Beer Mapping API here.

Locquery Service

(May Return Multiple Locations.)
http://beermapping.com/webservice/locquery/API_KEY/piece

This service should be used to search for Locations by querying the location name. Partials will work.
This function will return multiple locations depending on the search query given.

This query can be made either with a location name or with a location id.
The location name could possibly return more than one location, but location id's are all unique so they will only return one location or none if that id is not being used.

SimpleXMLElement Object
(
    [location] => SimpleXMLElement Object
        (
            [id] => 1000
            [name] => Piece Brewpub
            [status] => Brewpub
            [reviewlink] => http://beermapping.com/maps/reviews/reviews.php?locid=1000
            [proxylink] => http://beermapping.com/maps/proxymaps.php?locid=1000&d=5
            [blogmap] => http://beermapping.com/maps/blogproxy.php?locid=1000&d=1&type=norm
            [street] => 1927 West North Avenue
            [city] => Chicago
            [state] => IL
            [zip] => 60622
            [country] => United States
            [phone] => (773) 772-4422
            [overall] => 86.1905
        )

)

reviewlink: is the review page on beermapping.com
proxylink: is a map showing the location and all locations within a specific proximity. The default proximity of this map is 5 miles.
blogmap: is the url of a proximity map that is intended to be embedded in an iframe and it can be posted in a blog or site.

Loccity and Locstate Service

(May Return Multiple Locations.)
http://beermapping.com/webservice/loccity/API_KEY/lyons,co
http://beermapping.com/webservice/locstate/API_KEY/co

This service should be used to search for Locations when given a city or a city,state. Partials will work.
This function will return multiple locations depending on the search query given.

SimpleXMLElement Object
(
    [location] => SimpleXMLElement Object
        (
            [id] => 972
            [name] => Oskar Blues Grill and Brewery
            [status] => Brewpub
            [reviewlink] => http://beermapping.com/maps/reviews/reviews.php?locid=972
            [proxylink] => http://beermapping.com/maps/proxymaps.php?locid=972&d=5
            [blogmap] => http://beermapping.com/maps/blogproxy.php?locid=972&d=1&type=norm
            [street] => 303 Main Street
            [city] => Lyons
            [state] => CO
            [zip] => 80540
            [country] => United States
            [phone] => (303) 823-6685
            [overall] => 90.5555
        )

)

Locmap Service

(Should Return One Unique Location.)
http://beermapping.com/webservice/locmap/API_KEY/1000

This service should be used to return coordinate and map information based on the location id given.
Location Id's are unique and should return only one location.

SimpleXMLElement Object
(
    [location] => SimpleXMLElement Object
        (
            [name] => Piece Brewpub
            [status] => Brewpub
            [lat] => 41.910336
            [lng] => -87.675972
            [map] => northcentral
            [altmap] => chicago
        )

)

map: this will be the main map that this location will be found upon.
altmap: some locations (Breweries and Brewpubs) can be found on multiple maps. altmap is the second map where this location can be found.

Locscore Service

(Should Return One Unique Location.)
http://beermapping.com/webservice/locscore/API_KEY/1000

This service should be used to return score information based on the location id given.
Location Id's are unique and should return only one location.

SimpleXMLElement Object
(
    [location] => SimpleXMLElement Object
        (
            [overall] => 86.1905
            [selection] => 4.4285714285714
            [service] => 4.25
            [atmosphere] => 4.25
            [food] => 4.2916666666667
            [reviewcount] => 7
            [fbscore] => 4.6666666666667
            [fbcount] => 12
        )

)

reviewcount This is the number of times this location has been reviewed by users
fbscore: facebook.com score from our Breweries I've Visited application. This is an averaged score from all visits.
fbcount: The number of facebook.com users who have logged a visit to this location.

Locimage Service

(May Return Multiple Image Objects.)
http://beermapping.com/webservice/locimage/API_KEY/1000

This service should be used to return image information based on the location id given.

directurl: this is the link to the full sized image on beermapping.com.
imageurl: this is the direct image that can be included on your site.
thumburl: this is our generated thumbnail sized image for the full image that can be included on another site.
crediturl: this is the link to the beermapping.com user who uploaded the image originally.
imagedate: this is the date and time when the image was uploaded.

Beer Mappers Online:
38 Guests, 1 User
Beer Traveler

The Beer Mapping Project

We find the beer. You drink the beer.

Site Links

Site Info

Beer Maps

Location Info

RSS Feeds

Email Subscription

Locquery Service

Loccity and Locstate Service

Locmap Service

Locscore Service

Locimage Service