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
 }