Inhaltsverzeichnis
Die GIATA XML2 Schnittstelle ermöglicht das schnelle und einfache Abfragen der von GIATA erfassten Kataloge und Realtime Daten. Mit einer oft kurzen URL können Sie das große Spektrum der GIATA Daten für sich nutzen. Wir liefern Ihnen dafür die Rohdaten, die sie individuell in Ihre Reiseseite integrieren können.
Geliefert werden können: Bilder, Texte, Detaildaten des Hotels, Veranstalterinformationen, einfache Umgebungsdaten und Listen für einige wichtige Informationen
Ein einfaches Beispiel für einen Aufruf ist folgender:
http://www.giata-xml.de/?uid=XX&pwd=XX&show=hn,oc,vc,pic,txt&sc=hotel&acount=1&a[1][vc]=GIATA&a[1][oc]=40
Klicken Sie hier um sich die Ausgabe dieser Abfrage anzuzeigen
Für eine effiziente und einfache Abfrage wurde die Schnittstelle in drei Teile zerlegt.
Dies sind im Einzelnen:
Sie liefert eine Liste von Hotels, gefiltert nach Suchparametern wie Hotelname, Zielgebiet, Veranstalter. Diese Liste kann auf mehrere Seiten aufgeteilt werden.
Diese liefert die Informationen für ein sehr spezifisches Hotel, gesucht über Veranstaltercode (z.B. NEC, FTI), Buchungscode und/oder GIATA-Codes (im Folgenden GIATAID genannt). Dies ist auch die schnellste aller Suchmöglichkeiten und ist optimiert für die Darstellung eines einzelnen Hotels. Diese Suchmöglichkeit erlaubt es zudem, nach mehreren Hotels parallel zu suchen. Wir weisen explitzit darauf hin, dass jegliche Bearbeitung und Verwendung der GIATAID (des GIATA-Codes) zum Zwecke der Optimierung des Suchmaschinenrankings untersagt ist.
Diese Option liefert eine fertige Liste in einer für die XML Ausgabe idealen Form, um einen guten Mittelweg zwischen XML Validierung, Lesbarkeit und Geschwindigkeit zu ermöglichen. Hier erhalten Sie Listen der zur Verfügung stehenden Veranstalter, Länder, Zielgebiete, Orte und Kataloge.
Jede der Abfragen braucht die Angaben des Benutzernamens und des Passwortes, sowie die Angabe der gewünschten Suchmethode.
Ein Beispiel für eine Suche nach der GIATAID 5000 (Benutzername und Password sind hier wie überall in dem Dokument nicht gültig):
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=hotel&show=hn&gid=5000
Klicken Sie hier um sich die Ausgabe dieser Abfrage anzuzeigen
Anbei eine Liste der möglichen Parameter, welche die GIATA XML Schnittstelle versteht. Bitte beachten Sie, das nicht jeder Parameter zu jederzeit nötig ist, und nicht jede Kombination erfolgreich ist.
| Parameter | Benötigt | Beispiel | Kommentar |
|---|---|---|---|
| uid | Ja | 1345 | BenutzerID, wird von GIATA vergeben. Die BenutzerID ist immer eine Zahl. |
| pwd | Ja | XHdg35 | Das Passwort. Ebenso notwendig wie eine BenutzerID. Wird von GIATA vergeben. |
| sc | Ja | hotel | Art der Suche. Möglich sind: hotel,search,list |
| Parameter | Benötigt | Beispiel | Kommentar |
|---|---|---|---|
| show | Ja | txt,pic320,sn | Gibt an, welche Informationen des/der gefundenen Hotels angezeigt werden sollen. Bei Stammdatenlisten nicht nötig. |
| gid | Nein | 5000 | GIATAID |
| oc | Nein | GAMAS | Buchungscode |
| vc | Nein | toc [toc, nec] |
Selektierung eines Veranstaltercodes,
wie TOC, NEC, FTI, ADAC.
Bei Abfragen zu Details der Hotelsuche ist auch eine kommaseparierte Liste mehrer Veranstalter möglich. Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier. |
| vid | Nein | 186 [186, 306] |
Selektierung einer Veranstalter-ID.
Bei Abfragen zu Details der Hotelsuche ist auch eine kommaseparierte Liste mehrer Veranstalter-ID's möglich. Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier. |
| katid | Nein | 2324 |
ID des Kataloges, dessen Hotels
angezeigt werden sollen. Auch
kombinierbar. ID von GIATA vergeben
Die Abfragemöglichkeit einer Katalogliste finden Sie hier. |
| hn | Nein | Paloma | Hotelname, oder ein Teil eines Hotelnamens |
| hnt | Nein | Paloma |
Hotelname oder Teil eines Hotelnamens
per Textindex suchen.
Dieser Parameter ist ähnlich dem hn-Parameter, ist aber schneller. Er hat im Gegensatz zum hn-Parameter aber die Einschränkung, das nur vom Wortanfang an gesucht werden kann. Beispiele zur Suche im Hotelnamen 'Heuhotel Fischbeck': gefunden werden z.B. die Suchwörter 'Fischbeck', 'Fisch', 'Heu' nicht gefunden werden z.B. die Suchwörter 'isch', 'beck' |
| ln | Nein | spanien |
Landname, oder ein Teil eines
Landnamens.
Eine Abfragemöglichkeit für die Länderliste finden Sie hier. |
| lc | Nein | tr |
ISO-Ländercode
Die Abfragemöglichkeit einer Länderliste finden Sie hier. |
| zn | Nein | mallorca |
Zielgebietsname, oder ein Teil eines
Zielgebietsnamens.
Die Abfragemöglichkeit einer Zielgebietsliste finden Sie hier. |
| zi | Nein | 133 |
ZielgebietsID/DestinationID, interne
Nummer für ein Zielgebiet, von GIATA
vergeben
Die Abfragemöglichkeit einer Zielgebietsliste finden Sie hier. |
| sn | Nein | paris |
Stadtname, oder ein Teil eines
Stadtnamens.
Die Abfragemöglichkeit einer Städteliste finden Sie hier. |
| si | Nein | 132 |
StadtID/CityID, interne Nummer für eine
Stadt, von GIATA vergeben
Die Abfragemöglichkeit einer Städteliste finden Sie hier. |
| hkat | Nein | 3 | Die kleinste Kategorie, dem das Hotel entsprechen muss |
| date | Nein | 2008-06-11 |
Abfrage von Hoteldaten, die in einer
bestimmten Kataloglaufzeit
verfübar sind im Format 'yyyy-mm-dd' |
| ikatid | Nein | DERT2AC06 |
ID des Kataloges bei Infox.
Die Abfragemöglichkeit einer Infox-Kalogliste finden Sie hier. |
| fts | Nein | Harley |
Full-Text-Search, Parameter ist das
Suchwort. Mehrere Suchwörter werden
durch
Komma getrennt z.B. "fts=Streichelzoo,Österreich" wobei mehrere Suchwörter per AND-Verknüpfung gesucht werden. Die Default-Anzahl der Ergebnisse pro Seite beträgt 25, maximal möglich sind 50. |
| khid | Nein | 1183641 | Suche nach der Kataloghotel-ID, eine GIATA-interne ID für ein spezielles Hotel/Angebot in einem Katalog |
| ppa | Nein | 10 | Anzahl der Hotels pro Seite im Ergebnis, Vorgabe ist 100 |
| spa | Nein | 2 | Anzuzeigende Seite, Vorgabe ist Seite 1 |
| Parameter | Benötigt | Beispiel | Kommentar |
|---|---|---|---|
| show | Ja | txt,pic320,sn | Gibt an, welche Informationen des/der gefundenen Hotels angezeigt werden sollen. Bei Stammdatenlisten nicht nötig. |
| acount | Nein | 4 | Anzahl Abfragen, nur bei einer genauen Abfrage nach mehrerer Hotels notwendig |
| a | Nein | a[0]['vc']=toc |
Syntax, um mehr als eine Abfrage
gleichzeitig durchzuführen.
Acount ist notwendig, nimmt gid, oc und vc auf. (siehe unten) |
| gid | Nein | 5000 | GIATAID |
| oc | Nein | GAMAS | Buchungscode |
| vc | Nein | toc |
Veranstaltercode, wie TOC, NEC, FTI,
ADAC
Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier. |
| st | Nein | j,s,w | Grenzt die Katalogsaison ein |
| date | Nein | 2008-06-11 |
Abfrage von Hoteldaten, die in einer
bestimmten Kataloglaufzeit
verfübar sind im Format 'yyyy-mm-dd' |
| khid | Nein | 1183641 | Suche nach der Kataloghotel-ID, eine GIATA-interne ID für ein spezielles Hotel/Angebot in einem Katalog |
| Parameter | Benötigt | Beispiel | Kommentar |
|---|---|---|---|
| list | Ja | country | Gibt an, welche Liste geladen werden soll, möglich sind: country, destination, city, provider, catalog |
| lc | Nein | tr | Grenzt die Ausgabe der Länderliste (list=country) für einen bestimmten ISO-Code ein |
| zi | Nein | 345 | Grenzt die Ausgabe der Städte (list=city) für eine bestimmte GIATA ZielgebietsID ein. |
| vc | Nein | toc | Grenzt die Ausgabe der Katalogliste (list=catalog) auf einen Veranstalter ein. |
| Parameter | Kommentar |
|---|---|
| gid | GIATAID |
| hn | Hotelname |
| hk | Hotelkategorie |
| sn |
Stadtname
Die Abfragemöglichkeit einer Städteliste finden Sie hier. |
| si |
StadtID/CityID, Nummer für diese Stadt,
von GIATA vergeben.
Die Abfragemöglichkeit einer Städteliste finden Sie hier. |
| zn |
Zielgebietsname.
Die Abfragemöglichkeit einer Zielgebietsliste finden Sie hier. |
| zi |
ZielgebietsID/DestinationID, Nummer für
dieses Zielgebiet, von GIATA vergeben.
Die Abfragemöglichkeit einer Zielgebietsliste finden Sie hier. |
| ln |
Landname
Eine Abfragemöglichkeit für die Länderliste finden Sie hier. |
| lc |
Landcode, ISO-Ländercode für dieses
Land.
Eine Abfragemöglichkeit für die Länderliste finden Sie hier. |
| vc |
Veranstaltercode, wie TOC, NEC, FTI,
ADAC, DER usw.
Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier. |
| vn |
Veranstaltername
Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier. |
| vid | GIATA interne VeranstalterID |
| oc | Buchungscode |
| kn | Katalogname |
| katid | KatalogID |
| ks | Katalogseite |
| ps | Preisseite |
| khid | GIATA-interne ID für ein spezielles Hotel/Angebot in einem Katalog |
| kst |
Katalogsaison. Mögliche Werte sind:
S: Sommerkatalog W: Winterkatalog J: Jahreskatalog E: Endloskatalog |
| hk | Hotelkategorie/Hotelsterne |
| apos | Anfrageresultat, wichtig für die mehrfachsuche der Hotelanzeige. Gibt an welche Suche zu welchem Resultat gefürt hat |
| pic |
Bilder des Hotels in der maximalen Größe
320x320 Pixel (Vorgabe, wie pic320)
Erklärung der Bildtypen im Ergebnis |
| pic800 |
Bilder des Hotels in der maximalen Größe
800x800 Pixel
Erklärung der Bildtypen im Ergebnis |
| pic320 |
Bilder des Hotels in der maximalen Größe
320x320 Pixel
Erklärung der Bildtypen im Ergebnis |
| pic150 |
Bilder des Hotels in der festen Größe
150x120 Pixel
Erklärung der Bildtypen im Ergebnis |
| pic074 |
Bilder des Hotels in der maximalen Größe
74x74 Pixel
Erklärung der Bildtypen im Ergebnis |
| pics800, pics320, pics150, pics074, pics |
Wie pic800, pic320, pic150, pic074 und pics, nur das im
Falle eines nicht vorhandenen Bildes des Angebotes
ein Ersatzbild des Hotels ausgeliefert wird.
Dieses wird zufällig ausgewählt und kann auch von einem
anderen Veranstalter stammen. Es wird als Attribut die
KatalogHotel-ID des Angebots mitgeliefert, aus dem das
Angebot stammt. GIATA übernimmt keinerlei Gewähr und Haftung für die Ersatzbilder. Der Kunde setzt diesen Parameter auf eigene Gefahr ein und übernimmt die Haftung für jegliche Schadensersatzansprüche welche aus dem Einsatz dieses Parameters resultieren. Sollten ein oder mehrere Veranstalter den Einsatz dieses Parameters untersagen so hat der Kunde den Einsatz dieses Parameters auf seiner Webseite umgehend zu unterbinden. |
| txt | Textlink zum Objekttext |
| txta | Textlink zum Objekttext mit Attribut-Angaben zu Zeichensatz und Sprache |
| text | Beschreibungstext des Objektes als CDATA |
| lk | Landkarte |
| cli | Klimagrafik |
| cld |
Klimadaten als Werte, welche sich auf
eine Stadt, ein Zielgebiet oder ein Land
beziehen, was im Attribut
kind
kenntlich gemacht wird.
Temperaturangaben in Grad Celsius.
Die Abfragemöglichkeit einer Klimadatenliste finden Sie hier. |
| agb | AGB des Veranstalters |
| pano |
Panorama-Bild des Objekts
Erklärung der Panoramen-Typen im Ergebnis Die Abfragemöglichkeit einer Panorama-Liste finden Sie hier. |
|
PDF-Katalog-Seite des Objekts.
Eine Abfragemöglichkeit einer PDF-Katalogliste finden Sie hier. | |
| ikatid |
Infox-Katalog-ID
Die Abfragemöglichkeit einer Infox-Katalogliste finden Sie hier. |
| ds | Saisonstart des Kataloges im Format yyyy-mm-dd |
| de | Saisonende des Kataloges im Format yyyy-mm-dd |
| ic |
Imageclips, eine Flash-Anwendung inklusive Player.
Für den Bezug benötigen Sie eine separate Freischaltung. Wenden Sie sich hierfür bitte an <service@giata.de>
Es wird empfohlen. den ic-Parameter zusammen mit dem khid-Parameter aufzurufen, show=ic,khid,... Auslieferung eines Object/Embed-Tags als CDATA zum Einbinden in die HTML-Seite. Die Abfragemöglichkeit einer ImageClipListe finden Sie hier. Per Default werden die Clips mit einem Standard-Player ausgeliefert. Es ist aber möglich, einen individuellen Player nach Ihren Layout-Vorstellungen zu erhalten. Setzen Sie sich hierfür bitte mit GIATA in Verbindung - wir werden Ihnen ein attraktives Angebot machen. |
| ics |
Auslieferung von Ersatz-Imageclips, wenn
zum Angebot kein Originalclip vorliegt.
Siehe Parameter "ic". Es wird empfohlen. den ics-Parameter zusammen mit dem khid-Parameter aufzurufen, show=ics,khid,... Der Ersatzclip wird i.a. das Objekt mit Bildern aus einem anderen Katalog darstellen. Die Auslieferungsreihenfolge: 1. Originalclip zum Angebot 2. Ersatzclip über die Suche von Veranstaltercode und Buchungscode 3. Ersatzclip über die Suche von Veranstaltercode und GIATA-ID Das Attribut "kind" gibt an, ob es sich um einen Original- oder Ersatzclip handelt. (kind="original|substitute"). Im Falle eines Ersatzclips wird über das Attribut "khid" die KatalogHotel-ID des Ersatzclips geliefert. Die Abfragemöglichkeit einer ImageClipListe finden Sie hier. |
| cv | Links auf Katalogcover in der Größe 70 (70x100) und Größe 200 (200x300) |
| cv70 | Link auf Katalogcover in der Größe 70 (70x100) |
| cv200 | Link auf Katalogcover in der Größe 200 (200x300) |
| vl | Link auf Veranstalterlogo in den Größen 20,40,140 |
| vl20 | Link auf Veranstalterlogo in der Größe 20 |
| vl40 | Link auf Veranstalterlogo in der Größe 40 (40x20) |
| vl140 | Link auf Veranstalterlogo in der Größe 140 (140x30) |
| fc |
Existiert Flipcat zum Hotel?
1: ja 0: nein |
| tt |
Traveltype - Reiseart. Möglich Werte
sind:
P: Pauschalreise H: Hotel - Eigenanreise M: Mixed - gemischte Reisearten U: Unknown - Reiseart unbekannt leeres Ergebnis: keine Reiseart-Daten vorliegend Es wird, wenn vorhanden, die Reiseart auf Angebotsebene ausgeliefert. Ist diese nicht vorhanden, wird die Reiseart auf Katalogebene ausgeliefert. Es kann das Tag-Attribute "source" ausgeliefert werden: source="offer": Reiseartbestimmung des Objektes source="catalog": Reiseartbestimmung des Katalogs |
| ttc |
Traveltype auf Katalogebene.
Mögliche Werte sind: P: Pauschalreise H: Hotel - Eigenanreise M: Mixed - gemischte Reisearten U: Unknown - Reiseart unbekannt |
| maps |
GIATA tips&deals
Auslieferung eines Map-Links z.B. zum Einbinden in ein IFrame. Es wird empfohlen. den maps-Parameter immer zusammen mit dem khid-Parameter aufzurufen, also show=maps,khid,... Eine Abfragemöglichkeit einer tips&deals-Liste finden Sie hier. Für die Freischaltung benötigen Sie einen Zusatzvertrag, wenden Sie sich hierfür bitte an <service@giata.de>
.
|
| geo |
Breiten/Längengrad zum Objekt mit
Genauigkeitsangabe 'Accuracy' der
Geocodes.
Mögliche Werte für 'Accuracy' sind: 1: Hausnummer 2: Strasse 3: Stadteil/Gegend 4: Ort Die Abfragemöglichkeit einer Geocodes-Liste finden Sie hier. Für den Bezug benötigen Sie eine separate Freischaltung. Wenden Sie sich hierfür bitte an <service@giata.de>
.
|
| adr | Adresse
Für den Bezug benötigen Sie eine separate Freischaltung. Wenden Sie sich hierfür bitte an <service@giata.de>
.
|
| fact | Factsheet
Für den Bezug benötigen Sie eine separate Freischaltung. Wenden Sie sich hierfür bitte an <service@giata.de>.
Factsheet-Dokumentation |
| tds | Link zum kostenlosen
iPhone-Reiseführer
.
Es wird empfohlen. den tds-Parameter zusammen mit dem khid-Parameter aufzurufen, show=tds,khid,... |
| Parameter | Kommentar |
|---|---|
| A | Außenaufnahme |
| BA | Bar |
| F | Sport und Freizeit |
| FO | Folklore |
| GA | Garten |
| HB | Hallenbad |
| IT | Internetcafe |
| K | Konferenzraum |
| KL | Kultur |
| KU | Kunst |
| L | Lounge/Empfang |
| LG | Logo |
| LK | Landkarte |
| LS | Landschaft |
| LU | Luftaufnahme |
| MF | Mietfahrzeug |
| MHS | Meer/Hafen/Schiff |
| MOD | Modellaufnahme |
| NA | Natur |
| P | Pool |
| PE | Personen |
| PR | Preis |
| R | Restaurant |
| S | Strand |
| SE | Sehenswürdigkeiten |
| STA | Stadtansicht |
| TE | Terasse |
| TI | Tiere |
| WEL | Welness |
| W | Wohnbeispiel |
| X | Sonstiges |
| Parameter | Kommentar |
|---|---|
| AN | Außenansicht |
| AP | Wohnbeispiel, Appartment |
| AU | Außenansicht |
| BA | BAR |
| BD | Badezimmer |
| BG | Wohnbeispiel - Bungalow |
| CF | Café |
| EI | Eingang |
| ET | Etage/Flur |
| FI | Fitness |
| FR | Fitness/Wellness |
| FZ | Familienzimmer |
| GA | Gartenanlage |
| IN | Innenhof |
| KO | Konferenz |
| LO | Lobby |
| PB | Poolbar |
| PO | Poolanlage |
| RE | Restaurant |
| RZ | Rezeption |
| SB | Strandbar |
| SK | Skigebiet |
| SN | Snackbar |
| SP | Sport |
| ST | Strand |
| SU | Wohnbeispiel/Suite |
| SW | Schwimmbad |
| TE | Terasse |
| TS | Unterhaltung |
| ZI | Wohnbeispiel/Zimmer |
Für bestimmte Objektarten existieren Sammel-IDs, wobei
alle Objekte dieser Art über diese Sammel-IDs
angesprochen werden können wie z.B. die Objektart
Ferienhäuser.
Diese Sammel-IDs können wie folgt abgerufen werden:
http://www.giata-xml.de/?uid=xxx&pwd=xxx&sc=list&list=specialid
Eine direkte Suche nach diesen Sammel-Ids mit dem
Parameter sc=hotel ist nicht sinnvoll, vielmehr sollte
hier der Parameter
sc=search
verwendet werden.
Die Hotelsuche ermöglicht die einfache Suche nach verschiedenen Parametern. Die Hotelsuche ist die Funktion der Wahl, wenn sie z.B. alle Hotels auf Mallorca anzeigen möchten, eine Liste von Hotels deren Namen "Beach Resort" enthält erhalten möchten oder andere, ähnlich gelagerte Suchen durchführen müssen.
Eine Reihe von Beispielen soll dies verdeutlichen.
Suche nach einem Hotel mit dem Wort "Resort" im Namen:
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,vc,vn,txt,pic&sc=search&hn=resort
Suche nach Hotels auf Mallorca nach DestinationID (ID von Mallorca ist 133, siehe sc=list&list=destination&lc=es):
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,txt,vn,pic074,ln,sn,zn&sc=search&zi=133
Die selbe Suche erneut, diesmal nach dem Zielgebietsnamen "mallorca". Sie werden feststellen, das Variante 2) schneller ist
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,txt,vn,pic074,ln,sn,zn&sc=search&zn=mallorca
Alle Hotels des Kataloges "100034" (GIATA Online Hotels) anzeigen:
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,txt,vn,pic074,ln,sn,zn,katid&sc=search&katid=100034
Selbes wie 4), diesmal aber nur alle spanischen Hotels des Kataloges:
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,txt,vn,pic074,ln,sn,zn,katid,kn&sc=search&katid=100034&ln=spanien
Alle Türkischen Hotels, die bei FTI vorkommen und mind. 4 Sterne haben:
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,vn,ln,katid,kn,hk&sc=search&vc=fti&lc=tr&hkat=4
Das selbe Beispiel erneut, diesmal aber nur 10 Hotels pro Seite, und Seite 2 anzeigen:
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,vn,ln,katid,kn,hk&sc=search&vc=fti&lc=tr&hkat=4&spa=2&ppa=10
Objekte suchen, die im Objekt-Text das Wort "Harley" enthalten
http://www.giata-xml.de/?uid=XX&pwd=XX&show=hn,ln,zn,vc,txt&sc=search&fts=harley
Objekte suchen, die im Objekt-Text das Wort "Harley" und "Sauna" enthalten
http://www.giata-xml.de/?uid=XX&pwd=XX&show=hn,ln,zn,vc,oc,pic320,txt&sc=search&fts=harley,sauna
Objekte suchen, die im Objekt-Text das Wort "Streichelzoo" enthalten und in Österreich liegen
http://www.giata-xml.de/?uid=XX&pwd=XX&show=hn,ln,zn,vc,text&sc=search&fts=streichelzoo&ln=Österreich
Objekte suchen, die im Objekt-Text das Wort "Harley" und vom Veranstalter FTI oder NEC stammen
http://www.giata-xml.de/?uid=XX&pwd=XX&show=gid,hn,ln,zn,vc,txt&sc=search&fts=harley&vc=fti,nec
In dieser Abfrage wird die Giata-ID zurückgegeben.
Diese können Sie nutzen, um sich das gefundene Objekt auch von anderen Veranstaltern ausgeben zu lassen, obwohl das Suchwort eventuell gar nicht im Beschreibungstext eines anderen Veranstalters vorkommt.
Aufruf:
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,txt,vn,pic074,ln,sn,zn,katid&sc=search&gid=XXX
Bitte beachten Sie bei den Beispielaufrufen der Hotelsuche:
Die Informationen, die pro Hotel angezeigt werden, hängen vom verwendeten "show" Parameter ab. Um das zu verdeutlichen haben wir den "show"-Parameter bei den Beispielen variiert.
Die Hotelanzeige ist, wie bereits beschrieben, optimiert auf die Anzeige bzw. Übermittlung eines einzelnen Hotels. Die Hotelanzeige liefert anders als die Hotelsuche immer nur ein einziges Hotel pro Suchabfrage zurück. Außerdem sind die Suchmöglichkeiten weit geringer als bei der Hotelsuche. Allerdings ist die Hotelanzeige im Gegenzug dafür wesentlich schneller, und erlaubt mehr als eine Suchanfrage gleichzeitig.
Dieser Umstand macht sich vor allem bei Listen mit Hotels sehr stark bemerkbar.
Die einzigen Suchparameter, welche die Hotelanzeige unterstützt, sind die GIATAID (gid), der Buchungscode (oc) und der Veranstaltercode. Diese drei Angaben dürfen beliebig kombiniert werden, mind. eine Angabe ist allerdings nötig.
Das System verwendet folgende Suchlogik, wenn alle drei Parameter angegeben wurden:
Ist nur ein Teil der Parameter angegeben, wird natürlich auch nur ein Teil der Suchen durchgeführt.
Die Abfrage eines einzelnen Hotels ist sehr einfach.
Beachten Sie bitte, dass bei fehlender Veranstalter-Angabe der Default-Veranstalter GIATA verwendet wird.
Abfrage nach dem Veranstalter "FTI", dem Buchungscode "MM059" und der GIATAID 1795:
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,vn,ln,katid,kn,hk,pic320&sc=hotel&gid=1795&oc=MM059&vc=fti
Suche nach der GIATAID 3400:
http://www.giata-xml.de/index.php?uid=XX&pwd=XX&show=hn,vn,ln,katid,kn,hk,pic320&sc=hotel&gid=3400
Eine Mehrfachabfrage ermöglicht das Abfragen von mehreren Hotels, ohne dafür mehrer getrennte Anfragen an unsere XML Schnittstelle senden zu müssen.
Das mindert die Abfragezeit erheblich.
Der typische Einsatzort ist eine Liste mit Hotels, deren Buchungscodes und Veranstalter bekannt sind. Um ein Vorschaubild zu zeigen, müssen die Hotelinformationen für alle z.B. 10 Hotels abgefragt werden. Mit Einzelabfragen würde dies zu lange dauern, daher ist es möglich alle 10 Abfragen gleichzeitig stellen.
Als Basis für die weiteren Erklärungen, hier ein kleines Beispiel:
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=hotel&show=apos,hn,vc&acount=2&a[1][gid]=5000&a[1][vc]=fti&a[2][gid]=4500&a[2][vc]=fox
Das Ergebnis ist folgendes:
<result found="2">
<data id="0">
<Anfragenummer>1</Anfragenummer>
<Hotelname>Oasis Beach Hotel</Hotelname>
<Veranstaltercode>FTI</Veranstaltercode>
</data>
<data id="1">
<Anfragenummer>2</Anfragenummer>
<Hotelname>Hotel Sürmeli</Hotelname>
<Veranstaltercode>FOX</Veranstaltercode>
</data>
</result>
Die ersten Parameter (uid, pwd, sc,show) sind bereits bekannt.
Neu sind "acount" und der recht komplexe Teil um "a" herum:
acount=2&a[1][gid]=5000&a[1][vc]=fti&a[2][gid]=4500&a[2][vc]=fox
Die Anzeige wird etwas einfacher, wenn dieser Bereich aufgeschlüsselt wird:
acount = 2 Zwei gleichzeitige Abfragen
a Enthält die Abfragen
[1] Erste Abfrage, hat hier die Suche nach gid und vc
vc fti Veranstalter FTI
gid 5000 GIATAID 5000
[2] Zweite Abfrage, hat hier die Suche nach gid und vc
vc fox Veranstalter Fox-Tours
gid 4500 GIATAID 4500
"acount" enthält also die Abfragen, während "a" die Abfragen selbst enthält.
a[Nummer][Parameter]=Wert
Wenn "acount=5" ist, muss es auch 5 Abfragen geben, Nummer muss von 1 bis acount gehen. Parameter ist immer gid, oc oder vc, für jede Anfrage darf jeder Parameter einmal vorkommen. Es sollten nicht mehr als 10 Abfragen, höchstens 20 gleichzeitig durchgeführt werden
Um bei einer Mehrfachabfrage die Suche und das Ergebnis zuordnen zu können, ist der "show"-Parameter "apos" gedacht. Wird "apos" angegeben, enthält das Ergebnis für jedes Hotel die Abfragenummer, mit der es gefunden, oder nicht gefunden wurde. Im Ergebnis wird es "Anfragenummer" genannt, siehe Beispiel oben.
Eine Suche nach GIATA-IDs, die Sonder/Sammel-IDs sind, ist nicht sinnvoll und sollte mit dem Parameter "sc=search" durchgeführt werden.
Die Clips sind eine Flash-Anwendung inklusive Player.
Für den Bezug benötigen Sie eine separate Freischaltung.
Wenden Sie sich hierfür bitte an <service@giata.de>
Auslieferung eines Object/Embed-Tags als CDATA zum Einbinden in die HTML-Seite.
Mitgeliefert wird das Attribut "duration", welches die Laufzeit des Imageclips angibt.
Beispiel-Abruf über eine Hotelnamenssuche:
http://www.giata-xml.de/?uid=xxx&pwd=xxx&show=ic,hn,vc,vn,txt&sc=search&hnt=Doganay
Beispiel-Abruf über eine Volltextsuche:
http://www.giata-xml.de/?uid=xxx&pwd=xxx&show=ic,hn,vc,vn,txt&sc=search&fts=beach
Beispiel-Abruf über die eindeutige Katalog-Hotel-ID:
http://www.giata-xml.de/?uid=xxx&pwd=xxx&show=ic,hn,vn,ln,katid,kn&sc=hotel&khid=1552481
Die Clips basieren auf der eindeutigen KatalogHotel-ID. Liegt zu einer KatalogHotel-ID kein Imagclip vor, kann über den Parameter 'ics' ein Ersatzclip angefordert werden.
Dieser stellt i.a. das Angebot mittels Bilder aus einem anderen Katalog dar.
Die Auslieferungsreihenfolge:
Für Sonder/Sammel-Ids werden keine Ersatzclips ausgeliefert.
Ob ein Originalclip oder ein Ersatzclip ausgeliefert wurde, wird durch das Attribut "kind" gekennzeichnet:
Orignalclip: kind="original"
Ersatzclip: kind="substitute"
Ist der Clip ein Ersatzclip, wird über das Attribut "khid" die eigentliche KatalogHotel-ID des Ersatzclips angezeigt. Über diese kann dann z.B. der Katalog ermittelt werden, aus dem der Ersatzclip stammt.
Ersatzclip-Abruf-Beispiel über eine Hotelnamenssuche:
http://www.giata-xml.de/?uid=xxx&pwd=xxx&show=ics,hn,khid&sc=search&hnt=Fayna
Über den Aufruf
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=imageclip
können Sie sich eine Liste mit Giata-ID's anzeigen lassen, wobei zu jeder Giata-ID mindestens ein Clip vorliegt.
Über den Zusatz-Parameter "lastchange=X" können Sie die Angebote abrufen, bei welchen sich
eine oder mehrere Angebotseigenschaften ab dem Zeitpunkt X geändert haben.
http://www.giata-xml.de/?uid=xxx&pwd=xxx&show=hn,vn&sc=search&vc=nec&lastchange=1249373410
lastChange kann ein Timestamp sein oder alternativ alle Formate, die mit der php-Funktion
strtotime
geparst werden können.
In der XML-Ausgabe bekommen Sie in der root-node "result" über das Attribut "dataSafeSince" einen Zeitpunkt geliefert, bis zu dem der Datenzustand validiert ist. Diesen Zeitpunkt können Sie verwenden, um bspw. einige Zeit später einen erneuten XML-Abruf zu stellen und diesen Zeitpunkt nun für den lastchange-Parameter verwenden.
Um den Datenbestand der Angebote mittels des lastchange-Parameters synchron zu halten, müssen Sie noch ermitteln, ob Angebote gelöscht wurden. Dieses können Sie mittels des XML-Listenaufrufs list=delete ermitteln.
In keiner der beiden vorherigen Abfragemethoden ist es möglich, einfach auf die Listen der Länder, Zielgebiete und Städte von GIATA zuzugreifen. Auch eine Liste der Veranstalter oder Kataloge ist nur mit der Listenanzeige zugänglich.
Die Abfrage der Listen ist auch die einfachste aller Möglichkeiten.
Parameter: list=country
Weitere Parameter: keine, die Landliste wird immer komplett übertragen
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=country
Parameter: list=destination
Weitere Parameter: Filterung nach Land mit lc, z.B: lc=tr. Dieser Parameter ist pflicht.
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=destination&lc=tr
Parameter: list=city
Weitere Parameter: Filterung nach Land mit lc, z.B: lc=tr oder Filterung nach Zielgebiet mit zi, z.B. zi=149. Einer der beiden Parameter muss angegebnen sein
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=city&lc=tr
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=city&zi=149
Parameter: list=provider
Weitere Parameter: Keine Filter möglich
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=provider
Parameter: list=catalog
Diese Liste erfordert stets einen zusätzlichen Parameter. Entweder vc="Veranstaltercode" oder lang="Katalogsprache".
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=catalog&vc=toc
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=catalog&lang=en
Parameter: list=language
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=language
Es wird eine Liste mit Giata-Katalog-ID's und den URL's zu den Katalogen im PDF-Format ausgegeben
Parameter: list=pdf
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=pdf
Es wird eine Liste mit Giata-ID's ausgegeben, wobei zu jeder GIATA-ID mindestens ein ImageClip vorliegt.
Parameter: list=imageclip
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=imageclip
Es wird eine Liste mit Giata-ID's ausgegeben, bei welchen GIATA-ID's Daten von GIATA "tips&deals" vorliegen.
Die Liste ist aber nur abrufbar, wenn Sie für GIATA "tips&deals" freigeschaltet sind.
Parameter: list=maps
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=maps
Ausgabe einer Liste mit Giata-ID, Breiten/Längengrad und einem Wert 'Accuracy' für die Genauigkeit der Geocodes.
Parameter: list=geocode
Parameter: lc=Laendercode (optional)
Parameter: zi=Zielgebiets-ID (optional)
Parameter: si=Stadt-ID (optional)
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=geocode[&lc=X][&zi=X][&si=X]
Mögliche Werte für 'Accuracy' sind:
1: Hausnummer
2: Straße
3: Postleitzahl
4: Ort
Die Liste ist aber nur abrufbar, wenn Sie für den
Geocode-Bezug freigeschaltet sind, wenden Sie sich
hierfür bitte an
<service@giata.de>
.
Ausgabe einer Liste mit Giata-ID und Adressen-Angaben zum Objekt. Einige Adressen im Bestand sind von GIATA noch nicht vollständig verifiziert. Diese erkennen Sie am Attribut kind='unchecked'.
Parameter: list=address
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=address
Die Liste ist aber nur abrufbar, wenn Sie für den
Adressen-Bezug freigeschaltet sind, wenden Sie sich
hierfür bitte an <service@giata.de>.
Auslieferung der Klimadaten als Werte.
Diese können sich auf eine Stadt, ein Zielgebiet oder ein Land beziehen, was im Attribut kind kenntlich gemacht wird.
Temperaturangaben sind in Grad Celsius angegeben.
Parameter: list=climate[&lc=countrycode]
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=climate[&lc=countrycode]
Es wird eine Liste mit Giata-ID's und den URL's zu den Panoramen ausgegeben
Parameter: list=pano
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=pano
Es wird eine Liste mit Giata-Katalog-ID's und der Infox-Katalog-ID's ausgegeben.
Parameter: list=infox
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=infox
Sonder/Sammel-IDs bei Giata-IDs
Für bestimmte Objektarten existieren Sammel-IDs, wobei alle Objekte dieser Art über diese Sammel-IDs angesprochen werden können wie z.B. die Objektart Ferienhäuser. Diese Sammel-IDs können wie folgt abgerufen werden:
Parameter: list=specialid
http://www.giata-xml.de/?uid=xxx&pwd=xxx&sc=list&list=specialid
Firewall-Server-Liste
Wenn Sie für den XML-Zugriff Freischaltungen in Ihrer Firewall vornehmen müssen, finden sie hier ein Liste der Servernamen, die an den Datenauslieferungen per XML beteiligt sein können.
Es wird empfohlen, diese Liste einmal täglich zu aktualisieren.
Parameter: list=firewall
http://www.giata-xml.de/?uid=XX&pwd=XX&sc=list&list=firewall
Für weitere Fragen zu dieser Anleitung können Sie sich jederzeit
an Reno Bachor wenden, E-Mail:
<programmierung@giata.de>
.
Es gelten die Allgemeinen Geschäftsbedingungen der Giata Gesellschaft für die Entwicklung und Vermarktung interaktiver Tourismusanwendungen, die zur Kenntnis genommen wurden. Sie sind unter www.giata-mbh.de/agb abrufbar.