Structure of an asset

The Required and optional fields for your assets
  1. Required data
  2. Optional data
    1. types
    2. tags
    3. address
    4. contact
    5. openingHours
    6. userProperties

Required data

an asset element has the following minimal structure (More complete store example)

    "storeId": "unique identifier",
    "name": "Store Name",
    "location": {
        "lat": 43.600,
        "lng": 3.883

storeId, name and location are mandatory, everything else is optional.

The storeId field must be a unique identifier for your store. And match the following regexp [A-Za-z0-9]+

Optional data


types : an array of string

    "types": ["book_store", "library"]


tags: an array of string

    "tags": ["science", "comics"]



    "address": {
        "lines": ["Road name", "Another line of address"],
        "countryCode": "FR",
        "city": "Paris",
        "zipcode": "75000"


contact might contain website, phone and email values.

    "contact": {
        "website": "website url",
        "phone": "phone number",
        "email": "contact email"


In this example the store will be open between 8:30am and 19:30pm every day except sunday (7) where it’ll be closed. The december 24th 2015 the store will be open from 9:00am to 18:00pm and the december 25th 2015 the store will be closed.

For more details concerning Open Hours see the dedicated page Opening Hours.

    "openingHours": {
        "timezone": "Europe/Paris",
        "usual": {
            "7": [],
            "default": [{"start": "08:30", "end": "19:30"}]
        "special": {
        "2015-12-24": [{"start": "09:00", "end": "18:00"}],
                    "2015-12-25": []}


userProperties might contain additional user-defined data.