Versions Compared

Old Version 5

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user David Panofsky

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning

This documentation is obsolete. Please see updated documentation at http://docs.singleplatform.com/spv2/data-definitions/

Data Description

These are the descriptions of the fields included in the data we make available. All data is presented in JSON format.

...

  • id: the unique name of this location as used in the REST API and in the menu links. This is alpha-numeric.
  • factualId: the factual ID mapping for this location
  • outOfBusiness: indicates if the location is in business or out of business (i.e., closed). Valid values: true or false
    • NOTE: This field has been deprecated. While we still expose the field as to not disrupt existing publisher integrations, all values for outOfBusiness will be false.
  • businessType: the type of business for the location
  • publishedAt: the date the location was published
  • hasPhotos: indicates if a location has photos available via our Photos API (contact SinglePlatform to learn more about our photos service). Valid values: true or false

  • isOwnerVerified: indicates if a location is Owner Verified (i.e. SinglePlatform customer). Valid values: true or false

  • general
    • name: the name of the location
    • timeZone: time zone of the location
    • desc: general description of the location
    • website: location's existing website
  • location: address, directions, and other information about the physical location of the location
    • address1: physical street address of the location
    • address2: physical street address of the location
    • city: city of the location
    • region: region of the location (state, province, territory, etc.)
    • postcode: postal code of the location
    • country: the country in which the location resides
    • latitude: the latitude of the location
    • longitude: the longitude of the location
  • phones: a map of phone name to phone numbers. Each number is a 10 digit number with no dashes or spaces and no 1 at the beginning.
    • main: location's main number
    • fax: location's fax number
  • Hours: the daily opening and closing hours for a business

Sample Location Data

Here is a sample of what the location data would look like.

Code Block
titleSingle Location Entry
{
    "id": "island-prime",
    "factualId": "71f291e0-bef8-012e-5614-003048cad9da",
    "outOfBusiness": false,
    "publishedAt": "abc-kitchen2012-03-09 11:07:15",
    "general" : {
        "name" : "ABCIsland KitchenPrime",
        "timeZone" : "ESTPST",
        "desc": " : null,Resting on stilts atop San Diego Bay overlooking the city skyline and Coronado, there’s nowhere better than Island Prime & C Level to experience quintessential San Diego.  \r\n\r\nIsland Prime and C Level are two concepts under one roof!  Enjoy the casual side at C Level for lunch where it is first come, first serve in our dining room, lanai and outside terrace.  Island Prime is open for dinner and reservations are recommended but NOT required.",
        "website" : "http://www.abchomeislandprime.com/systemPage/services/restaurants/abckitchen/tabid/893/Default.aspx"
    },
    "location" : {
        "address1" : "35880 EastHarbor 18thIsland StreetDr",
        "address2" : null"",
        "city" : "NewSan YorkDiego",
        "region": "CA",
        "country": "NYUS",
        "postcode": "92101",
        "longitude": -117.19415,
"10003"        "latitude": 32.72494,
        "state": "CA",
        "zipCode": "92101"
    },
    "phones": {
        "main": "619-298-6802",
        "fax": null
    },
    "hours": {
        "mon": {
            "start": "11:30am",
            "end": "12:00am"
        },
        "tue": {
            "start": "11:30am",
            "end": "12:00am"
        },
        "wed": {
            "start": "11:30am",
            "end": "12:00am"
        },
        "thu": {
            "start": "11:30am",
            "end": "12:00am"
        },
        "fri": {
            "start": "11:30am",
            "end": "12:00am"
        },
        "sat": {
         "main"    "start": "11:30am",
            "end": "2124755829",12:00am"
        },
        "fax" : "2125983020"sun": {
            "start": "11:30am",
            "end": "12:00am"
        },
        "holidaySchedule": ""
    },
    "hasPhotos": true,
    "businessType": "Restaurant",
    "isOwnerVerified": true
}
Code Block
titleList of Locations
[
    {
        "id": "union-square-cafe",
        "factualId": "abc-kitchen",8f1687c6-2a90-4706-a99f-914c55be32a9",
        "outOfBusiness": false,
        "publishedAt": "2012-03-09 11:04:04",
        "general" : {
            "name" : "ABCUnion Square KitchenCafe",
            "timeZone" : "EST",
            "desc" : null,: "In October of 1985, Danny Meyer opened his first restaurant, Union Square Cafe. A new breed of American eatery, USC paired imaginative food and wine with caring hospitality, comfortable surroundings and exceptional value. Serving American cuisine with an Italian soul, USC was an immediate hit. From outstanding wines by the glass, dining at the bar and seasonal ingredients to an emerging downtown location and a mission to support our community, USC has changed the restaurant landscape in NYC and across the country. A critical success from the outset, USC has twice garnered The New York Times' three-star rating, and also earned Zagat Survey's #1 ranking as New York's Most Popular Restaurant for an unprecedented eight years.",
            "website" : "http://www.abchomeunionsquarecafe.com/systemPage/services/restaurants/abckitchen/tabid/893/Default.aspx""
        },
        "location" : {
            "address1" : "3521 EastE 18th16th StreetSt",
            "address2" : null"",
            "city" : "New York",
            "region": "NY",
            "country": "NYUS",
            "postcode": "10003",
            "longitude": -73.99169,
            "latitude": 40.73692,
            "state": "NY",
            "zipCode": "10003"
        },
        "phones" : {
            "main" : "2124755829212-243-4020",
            "fax" : "2125983020212-627-2673"
   }     },
        "hours": {
            "id" : "les-halles",
  "general" : {
    "name" : "Les Halles",
    "timeZone" : "ESTmon": {
                "start": "12:00pm",
                "end": "10:00pm"
            },
            "tue": {
                "start": "12:00pm",
                "end": "10:00pm"
            },
            "wed": {
                "start": "12:00pm",
    "desc" : null,            "end": "10:00pm"
            },
            "thu": {
    "website"             "start": "12:00pm",
                "end": "http://leshalles.net/"10:00pm"
            },
            "location" : {"fri": {
                "start": "12:00pm",
                "address1end": "11:00pm"
            },
           "411 Park Avenue South "sat": {
                "start": "12:00pm",
    "address2" : null            "end": "11:00pm"
            },
    "city" : "New York",        "sun": {
                "start": "12:00pm",
                "regionend" : "NY",10:00pm"
            },
            "postcodeholidaySchedule" : "10016"
        },
       "phones" :  "hasPhotos": true,
        "businessType": "Restaurant",
        "isOwnerVerified": true
    },
    {
        "mainid" : "2126794111banc-cafe",
        "faxfactualId" : "2122132065"a2e3baf2-eae4-4017-98d1-1cf4ab02d145",
  }
},
{      "outOfBusiness": false,
        "idpublishedAt" : "les2012-halles-2",03-09 10:35:56",
        "general" : {
            "name" : "LesBanc HallesCafe",
            "timeZone" : "EST",
            "desc" : null,: "A neighborhood bar restaurant occupying the space of a 1920's bank. The decor is inspired by nineteenth century Parisian establishments. Terra Cotta textured walls, dimly lit chandelier's, copper table tops & curved banquette seating create a very unique and intimate setting. Executive Chef, John J. Loughran formerly of River Cafe in Brooklyn has created a menu that changes seasonally using the best of locally sourced ingredients. Chef John's philosophy, buy local and be creative. This is evident in every dish you taste at Banc Cafe. Our cocktails are created using fresh fruit & natural ingredients.We feel that tasty food & flavorful drinks provided with honest friendly service is a great way to win someone over. We hope that someone is you. Enjoy!",
            "website" : "http://leshalleswww.banccafe.netcom/"
        },
        "location" : {
            "address1" : "15431 John3rd StreetAve",
            "address2" : null"",
            "city" : "New York",
            "region": "NY",
            "country": "NYUS",
            "postcode": "10016",
            "longitude": "10038"
  },
  "phones" : {
    "main" : "2122858585",
    "fax" : "2127913280"
  }
} ]
-73.97973,
            "latitude": 40.74351,
            "state": "NY",
            "zipCode": "10016"
        },
        "phones": {
            "main": "212-252-0146",
            "fax": null
        },
        "hours": {
            "mon": {
                "start": "11:00am",
                "end": "04:00am"
            },
            "tue": {
                "start": "11:00am",
                "end": "04:00am"
            },
            "wed": {
                "start": "11:00am",
                "end": "04:00am"
            },
            "thu": {
                "start": "11:00am",
                "end": "04:00am"
            },
            "fri": {
                "start": "11:00am",
                "end": "04:00am"
            },
            "sat": {
                "start": "11:00am",
                "end": "04:00am"
            },
            "sun": {
                "start": "11:00am",
                "end": "04:00am"
            },
            "holidaySchedule": ""
        },
        "hasPhotos": true,
        "businessType": "Restaurant",
        "isOwnerVerified": true
    }
]