API URL:

http://{server_url}/dre/api/rest/vertical/list

For example, location is Toronto, time is 12:30pm:

http://d.2ya.it/dre/api/rest/vertical/list?time=1371831759371&appId={AppID}&lat=43.653226&lng=-79.3831843

Input Parameters:

appId – your appId assigned to your app

time – System time in milliseconds on the device (Since Jan 1, 1970)

lat – current Latitude

lng – current Longitude

Response:

list of vertical objects with following fields:

name – name (should be displayed as the title)

type – the vertical type (e.g. restaurants, movies, cafes, bars, youtube etc), this should be used to make a call to appropriate vertical for more information

query (optional)- the query string to pass back to the server when user clicks on it for more information

imageurl (optional) – this image must be rendered as a background if present (else use default image for the vertical locally)

iconurl (optional) – icon to be displayed if present

itemid (optional) – id of the single specific entity, if the returned item refers to a single entity (not a list)

rating (optional) – rating bar to be shown if present (only applies to single entities)

<verticals>
    <vertical>
        <itemid>1929472</itemid>
        <name>B√Ęton Rouge Restaurant</name>
        <type>restaurants</type>
    </vertical>
    <vertical>
        <id>3</id>
        <name>Lunch</name>
        <query>lunch</query>
        <type>restaurants</type>
    </vertical>
    <vertical>
        <id>6</id>
        <name>Movies</name>
        <type>movies</type>
    </vertical>
    <vertical>
        <id>2</id>
        <name>Coffee/Tea</name>
        <query>coffee tea</query>
        <type>cafes</type>
    </vertical>
    <vertical>
        <id>7</id>
        <name>Videos</name>
        <type>youtube</type>
    </vertical>
    <vertical>
        <id>8</id>
        <itemid>1853440</itemid>
        <name>Hard Rock Cafe</name>
        <type>cafes</type>
    </vertical>
    <vertical>
        <id>9</id>
        <itemid>9bZkp7q19f0</itemid>
        <name>Gangnam Style</name>
        <type>youtube</type>
    </vertical>
    <vertical>
        <id>10</id>
        <itemid>119301</itemid>
        <name>Fast & Furious 6</name>
        <type>movies</type>
    </vertical>
    <vertical>
        <id>11</id>
        <name>Restaurants nearby</name>
        <type>restaurants</type>
    </vertical>
</verticals>

Notes:

  • If a returned vertical has a itemid it means that it refers to a single entity and you must call the api on the particular vertical type to request detailed information and display the details page as you would do for normal click on a listing
  • if itemeid is in not present then you must call the appropriate vertical api to request the list and display it as you normally would for that vertical, include the query if present
  • lat/lng should be added to requests as you would do normally do for listing and/or details
  • image from imageurl should be rendered as a background if present, else use default image for that vertical
  • rating bar should be displayed if present