meta-service: hypersearch

meta-service: hypersearch

Entry Point

Responsetype

TemplateBased-XML-Response
TemplateBased-JSON-Response
TemplateBased-Protobuff-Response

Description

The meta.destination.one hyper search is a meta-search based on meta-data.

The meta.destination.one API provides data from data, as well as from vendors that provide ecMaps-4.0-compliant GeoRSS Feed feeds.
This API is the basic building block of ecMaps.
Thus, this is a meta-search.

The meta.destination.one-hyper API takes the data from meta and enriches it with other data.

Functionality:
  1. Search for landlords via meta
  2. Search bookable rooms / apartments / packages to the landlords with out hyper-providers Booking.com, Et4Freimeldung, Feratel, NetHotels, butterfly, Seekda, Tiscover, Tomas, Wild East, ...
  3. Data are blended and exported as a feed, or output rendered from the eT4.Meta templates.
    Supported templates are: ET2014A, ET2014A_HYPER and eSuchWas (feed),
Requirements for this functionality is that the respective provider ID is provided in the data in meta.
The internal provider id has to be saved in the correspanding elements (SYSTEMID_TOMAS, SYSTEMID_SCHMETTERLING [...]).

Parameters

Obligatory in eT4.META-HyperSearch:

Parameter
Type
Description
template
String
The template determines the output format of the data and the desired version of the eT4®META schemas.  (Supported templates: eSuchWas, ET2014A, ET2014A_MULTI, ET2014A_HYPER)
experience
String
The experience specifies the name of the project data pool to be used.  (obligatory)
type
String
Used to specify the main content type/topic to search. Hotel, Event, Gastro, Tour, POI, City, Area, Package, Article or Web.
occupation
String
Occupations
startdate
Date
startdate
enddate
Date
enddate

These are optional parameters in eT4.META-HyperSearch:

Parameter
Type
Description
hypersort
String
Sort of the results: BookableFirst, Price, PriceDesc, Name, NameDesc, Relevance, HighlightPrice, Distance, HighLightStarsPrice, HighlightStarsDescPrice, Meta, SpecialLastChange, Plz, City (Default: Price)
pricefrom
Decimal
price from
priceto
Decimal
price to
removeemptyitems
Boolean
If true, all items without hyperobjcts will be removed from response. (Default: true)
activatecaching
Boolean
if false, no caching will be used. (Default: true)

All parameters of meta.destination.one-search can be used in hyper, too (especially q, request, template, limit, offset).
See its complete documentation for more Information.

Integration

  1. Display destination.one meta content and asynchronous loading of hyper-informations for each object in list view.
    The main advantage of this method is that the meta-results appear very quickly.
    The hyper-query always takes a few seconds to load because many providers have to be contacted.
    Compare list view http://pages.et4.de/de/demo-dahoam/default/search/Gastgeber

    List based on meta:
    http://meta.et4.de/rest.ashx/search/?experience=demo-dahoam&type=Hotel&limit=20&offset=0

    One hypercall per object:
    http://meta.et4.de/rest.ashx/hypersearch/?template=ET2014A_HYPER.json&experience=demo-dahoam&type=Hotel&startDate=01.05.2015&endDate=08.05.2015&Occupation=2&q=hashlink:278FE57D1249A8AC40CCE07D6A5D5AA5

  2. Display hyper content directly with Paging
    The main advantage of this method is that all data are visible at the same time.
    Major drawback, however, is that the user has to wait for the results to complete.

    List generated directly by hyper:
    http://meta.et4.de/rest.ashx/hypersearch/?template=ET2014A.xml&experience=demo-dahoam&type=Hotel&startDate=01.05.2015&endDate=08.05.2015&Occupation=2&limit=20&offset=0

  3. Display hyper information on detail pages of object
    same call as in first Integration-Sample.
    http://meta.et4.de/rest.ashx/hypersearch/?template=ET2014A_HYPER.json&experience=demo-dahoam&type=Hotel&startDate=01.05.2015&endDate=08.05.2015&Occupation=2&q=hashlink:278FE57D1249A8AC40CCE07D6A5D5AA5

Templatesamples

ET2014A.xml
ET2014A.json
ET2014A.pb
ET2014A_HYPER.xml
eSuchWas (GeoRss-Feed)

Samples

Sample 1

Get hyperinformation from experience demo-dahoam to one object (hashlink 419FE08232977EA5429DA7D5E836E566) for 2 adults with 1 child (age 2) from 01.05.2015 to 08.05.2015 as JSON

Sample 2

Get hyperinformation from experience demo-dahoam for 2 adults with 1 child (age 4) from 01.05.2015 to 08.05.2015 for page 2 with 10 items  

Sample 3

Get hyperinformation from experience demo-dahoam for hotels only with 3+ stars for 2 adults with 1 child (age 1) from 01.05.2015 to 08.05.2015 for page 2 with 10 items  

    • Related Articles

    • meta-Service: types

      Entry Point http://meta.et4.de/rest.ashx/types/ Responsetype JSON-Response Description The types service returns a list of available topics. Parameters none Samples Sample 1: http://meta.et4.de/rest.ashx/types/
    • meta-service: features

      Entry Point http://meta.et4.de/rest.ashx/features Responsetype XML or JSON Response Description The features service returns all available features for the specified project. Parameters Parameter Type Description experience String The experience ...
    • meta-service: categories

      Entry Point http://meta.et4.de/rest.ashx/categories Responsetype XML or JSON-Response Description The destination.one meta categories service returns all available categories for the specified project. Parameter Type Description experience String The ...
    • meta-service: keyterms

      Entry Point http://meta.et4.de/rest.ashx/keyterms  Responsetype JSON-Response Description The destination.one meta KeyTerms service returns keyterms to one object. Parameters Parameter Type Description experience String The experience specifies the ...
    • meta-Service: shortenurl

      Entry Point http://meta.et4.de/rest.ashx/shorten-url Responsetype JSON-Response Description destination.one Url-Shortener. Parameters Parameter Type Description url String Url that shall be shortenend Samples Sample 1: www.hubermedia.de ...