Venue

This is the establishment where a Convention or Gathering takes place. Most of the time we pull the data from Google, but you can also create your own. Venues are accessed via /api/venue.

Properties

See "Object Properties" in Introduction for basic shared properties.

Complete details in VenueProperties.

Relationships

See "Relationships" in Introduction for how to use them.

conventions

The list of Conventions that use this venue. Please note that we may have multiple venue objects in the system that represent the same venue, because venue data changes over time.

Services

The services used to fetch and manipulate venues.

Search Venues

You must be logged in to use this service.

 GET /api/venue
Optional Params
query

Searches a partial name.

Returns:

 {
    "paging" : {...},
    "items" : [
        {
          "id" : "xxx",
          "name" : "Monona Terrace and Convention Center",
          ...
        },
        ...
    ]
 }

Search Google For Places

 GET /api/venue/google/search
Required Params
latitude
longitude
name

Returns:

 {
      "items" : [
         {
            "photos" : [
               {
                  "width" : 4048,
                  "html_attributions" : [
                     "<a href=\"https://maps.google.com/maps/contrib/118346018238992057497/photos\">Pete Teoh</a>"
                  ],
                  "photo_reference" : "CoQBdwAAAID7GFcmTLVa5-q3VjDbQ2mMp-21EcSJ7kCEoJk0SRu1hnoFR70by0fakI30SPq0IFZ0LYdSL3aaFOLQ9FrGYbvAerEskKs_dW84bWwNcMc_fa_MmaZ0QEknZaWy-aqifwR_UCElHGYoC_MTzwLHz4Zf1DeSvN7x51cXva0rc536EhDEU1GfqHwq6VHL_4T_2i9QGhS_yjhQIgxUgTRU_JSXYNhrFfEuvQ",
                  "height" : 3036
               }
            ],
            "icon" : "https://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
            "types" : [
               "point_of_interest",
               "establishment"
            ],
            "name" : "Jacob K. Javits Convention Center",
            "rating" : 4.3,
            "reference" : "CmRSAAAANQ8dqZgDFyiUHaiAS_zodCiL5y8p9p8ZErnYZa4obh3ljTJCZmT2o_b1eE7gyI-t-_QdELY_mZ7JrNIQ3u7BWbYtXTQITUtGi3_SFdG_rVcJzqtw-1VpioaE-loISxw9EhCB7-Fj4RK6pY7MKoOCqJIwGhSmeA6Vyjt_u4lzRFgoJQ3BDPqGZQ",
            "place_id" : "ChIJBdPBg2P2wokRg96tvVaRWLE",
            "geometry" : {
               "viewport" : {
                  "southwest" : {
                     "lat" : 40.75577075,
                     "lng" : -74.0039944
                  },
                  "northeast" : {
                     "lat" : 40.75844575,
                     "lng" : -74.0021232
                  }
               },
               "location" : {
                  "lat" : 40.757777,
                  "lng" : -74.002591
               }
            },
            "id" : "798d3c650860e46d84d25e4729ecbe2afc51011d",
            "vicinity" : "655 West 34th Street, New York",
            "scope" : "GOOGLE"
         },
         ...
      ]
 }

Create Venue from Google Place

 POST /api/venue
Required Params
name
place_id

Get the place_id by using the Search Google for Places service (above).

Returns the same as a normal read.

Create Venue from Address

If you want to create a venue that you can't find via the Google Places API, like a house or a very new business, then use this service instead.

 POST /api/venue/google/geocode
Required Params
name
formatted_address

Something like 123 Main St, Springfield, WI.

Returns the same as a normal read.

Read Venue

 GET /api/venue/xxx

Returns:

 {
   "id" : "xxx",
   "name" : "Monona Terrace and Convention Center",
   ...
 }

Update Venue

 PUT /api/venue/xxx

Returns the same as a normal read.

Delete Venue

 DELETE /api/venue/xxx

Returns:

 {
   "success" : 1
 }