Search Media Type

The search media type describes a step in a user activity to find/discover places.

{
  "search": {
    //...
  },
  "results" : {
    "items": [
      //...
    ]
  }
}

The primary information about the search context is the location context that the service has chosen for the query. Usually the location context is derived from the explicit location parameters of a discover activity. But sometimes the location context is also derived from other elements, particularly from a user's search term. For example, when a user located in "Berlin, Germany" uses the search term is "Restaurant in Paris", the search algorithm uses "Paris" as the search location.

When the location context of a place discovery is derived from one of the explicit location parameters, the selected one is returned in the result. Depending on the endpoint used, it may also contain an address or area of the location:

{
  "search": {
    "context": {
      "title": "Paris",
      "location": {
        "position": [52.5044, 13.3909]
        "address": {
          "city": "Paris",
          "country": "France",
          "text": "Paris<br/>France"
          //...
        }
      },
      "type": "urn:nlp-types:place"
    }
    //...
  }
}

Result items of type search contain the context used for the search, which includes the following attributes: