Quick Search method [ORS Documentation]

ors-soap-api:public:quicksearch

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== Quick Search method ======

Returns a list of hotels / places or countries by sending ''query'' string. 

Query string is a string that user enters in quick search field. You can specify which lists do you want to return by defining ''types'' attribute.

<WRAP center round important 90%>
This method is only available for content type **dhotel**

We urge you to use this CSV export files for regions and cities instead:
( Available languages: SI, EN, DE, HR, RS )

  * [[http://ors.si/csvs/regions_si.csv]]
  * [[http://ors.si/csvs/oids_si.csv]]

</WRAP>



===== Valid content types =====

  * ''dhotel'' (**only this type is currently supported!**)

===== Description =====

<code php>
public array quicksearch( array $searchData, array $headerData )
</code>

===== Parameters =====

  * ''searchData (array)'' : search parameters. Required search parameters: ''query'' (''types'' is optional)
  * ''headerData (array)'' : [[soap_header|SOAP Header Information]]

===== Return Values =====

Gets a list of hotels, places and countries that matches query string.

<code>
Array
(
    [hotel] => Array
        (
            [0] => Array
                (
                    [code] => PL8415.200.2
                    [name] => PL8415.200.2 Dom Zdrojowy
                    [gid] => !interhome:IlBMODQxNS4yMDAuMiI=
                    [oid] => 17440
                    [hon] => Jastarnia
                    [cntyiso] => PL
                    [country] => Poland
                )

            [1] => Array
                (
                    [code] => PL8415.200.6
                    [name] => PL8415.200.6 Dom Zdrojowy
                    [gid] => !interhome:IlBMODQxNS4yMDAuNiI=
                    [oid] => 17440
                    [hon] => Jastarnia
                    [cntyiso] => PL
                    [country] => Poland
                )

        )

    [places] => Array
        (
            [0] => Array
                (
                    [oid] => 47032
                    [hon] => Busko Zdroj
                    [cntyiso] => PL
                    [country] => Poland
                )

            [1] => Array
                (
                    [oid] => 62847
                    [hon] => Wysowa ZdrĂłj
                    [cntyiso] => PL
                    [country] => Poland
                )

        )


    [regions] => Array
        (
            [0] => Array
                (
                    [code] => 100434
                    [name] => Kvarner
                )

            [1] => Array
                (
                    [code] => 99990088
                    [name] => Kvarner hribi
                )

        )        

    [countries] => Array
        (
            [0] => Array
                (
                    [code] => US
                    [name] => Združene države Amerike
                )

        )
</code>

===== Return parameters =====

  * ''hotel'' (array) : a list of hotels
    * ''code'' : object unique code
    * ''gid'' : object GIATA ID
    * ''name'' : object name
    * ''hon'' : city name
    * ''oid'' : city ID
    * ''cntyiso'' : country ISO code
    * ''countrya'': country name
  * ''places'' (array) : a list of places
    * ''hon'' : city name
    * ''oid'' : city ID
    * ''cntyiso'' : country ISO code
    * ''countrya'': country name
  * ''regions'' (array) : a list of regions
    * ''code'' : region code (rgc)
    * ''name'' : region name
  * ''countries'' (array) : a list of countries
    * ''code'' : country ISO code (2 characters)
    * ''name'' : country name

===== Examples =====

  * Example of ''quicksearch'' request

<code php>
$searchParams = array(
  'query' => 'zdr',       // search string
  'types' => 'hotel,places,countries,regions',       // type of lists to return
);

// this is the same as upper array (when types is empty then quicksearch returns all of the lists)
$searchParams = array(
  'query' => 'zdr',       // search string
);

$results = $soapClient->orsxml_dhotel_api_call( 'quicksearch', $searchParams, $header );
</code>

  * Example of ''quicksearch'' request (return only places)

<code php>
$searchParams = array(
  'query' => 'zdr',       // search string
  'types' => 'places',       // type of lists to return
);

$results = $soapClient->orsxml_dhotel_api_call( 'quicksearch', $searchParams, $header );
</code>

  * Example of ''quicksearch'' request (return only regions)

<code php>
$searchParams = array(
  'query' => 'kvarner',       // search string
  'types' => 'regions',       // type of lists to return
);

$results = $soapClient->orsxml_dhotel_api_call( 'quicksearch', $searchParams, $header );
</code>

ors-soap-api/public/quicksearch.txt · Last modified: 2017/05/19 10:03 by admin