Inhaltsverzeichnis
2019-04-01: Umstellung der Authentifizierung auf httpd basic authentication
2019-03-25: Textlinks pro https (giatamedia.com)
2019-03-11: der Wert der Suchparameter Landname (ln), Zielgebietsname (zn), Stadtname (sn) muss nun mindestens 3 Zeichen lang sein
2019-03-06: Einführung des Zusatzparaneters "ocexact" um eine Angebotssuche über exakte Buchungscodesuche (ohne Teilwortsuche) zu erzwingen
2019-03-01: Entfernung der Imageclips (show-parameter "ic", "ics")
Die GIATA XML Schnittstelle ermöglicht das schnelle und einfache Abfragen der Angebotsdaten in den von GIATA erfassten Katalogen 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 Angebots, Veranstalterinformationen, einfache Umgebungsdaten und Listen für einige wichtige Informationen
Der Zugriff auf die Ressourcen dieses Webservice ist passwortgeschützt über die HTTP Basic-Authentifizierung. Der Benutzername für die Authentifizierung ist die in der Freischaltmail mitgeteilte "XML User ID".
Das Passwort bestimmen Sie selbst über den "Link zum Passwort setzen" in der Freischaltmail.
Codebeispiel 1 für die Authentifizierung per shell/curl:
curl --user "your-uid":"your-password" 'https://xml.giatamedia.com/?show=hn,khid,vc&sc=search&gid=3'
Codebeispiel 2 für die Authentifizierung per php:
<?php
$username = "your-uid";
$password = "your-password";
$search = "your-search-parameter"; // sc=search&show=hn,khid,vc,oc,gid&oc=ABC&vc=DEF12345&gid=123456
$remote_url = 'https://xml.giatamedia.com/?' . $search;
$opts = array('http'=>array('method'=>"GET",
'header' => "Authorization: Basic ". base64_encode("$username:$password")));
$context = stream_context_create($opts);
$file = file_get_contents($remote_url, false, $context);
print($file);
Für eine effiziente und einfache Abfrage wurde die Schnittstelle in drei Teile zerlegt.
Dies sind im Einzelnen:
Sie liefert eine Liste von Angeboten, gefiltert nach Suchparametern wie Angebotsname, Zielgebiet, Veranstalter. Diese Liste kann auf mehrere Seiten aufgeteilt werden.
Diese liefert die Informationen für ein sehr spezifisches Angebot, 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 Angebots. Diese Suchmöglichkeit erlaubt es zudem, nach mehreren Angeboten 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.
Schematischer Beispiel-Aufruf für die Suche nach einer GIATAID mit Veranstalter: (Benutzername und Password sind hier wie überall in dem Dokument nicht gültig):
https://xml.giatamedia.com/?sc=hotel&show=hn&gid=X&vc=X
Anbei eine Liste der möglichen Parameter, welche die GIATA XML Schnittstelle versteht. Bitte beachten Sie, dass nicht jeder Parameter zu jederzeit nötig ist, und nicht jede Kombination erfolgreich ist.
| Parameter | Benötigt | Beispiel | Kommentar |
|---|---|---|---|
| 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 der gefundenen Angebote angezeigt werden sollen. Bei Stammdatenlisten nicht nötig. |
| gid | Nein | 5001 | GIATAID |
| oc | Nein | GAMAS | Buchungscode |
| vc | Nein | toc [toc, nec] |
Selektierung eines Veranstaltercodes,
wie TOC, NEC, FTI, ADAC.
Bei Abfragen zu Details der Angebotssuche ist auch eine kommaseparierte Liste mehrerer Veranstalter möglich. Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier. |
| vid | Nein | 186 |
Selektierung einer Veranstalter-ID.
Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier. |
| katid | Nein | 2324 |
ID des Kataloges, dessen Angebote
angezeigt werden sollen. Auch
kombinierbar. ID von GIATA vergeben
Die Abfragemöglichkeit einer Katalogliste finden Sie hier. |
| hn | Nein | Paloma | Angebotsname, oder ein Teil eines Angebotsnamens |
| hnt | Nein | Paloma |
Angebotsname oder Teil eines Angebotsnamens
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 Angebotsnamen '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. |
| hk | Nein | 3 | Die kleinste Kategorie, dem das Angebot entsprechen muss |
| date | Nein | 2008-06-11 |
Abfrage von Angebotsdaten, 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. |
| khid | Nein | 1183641 | Suche nach der Kataloghotel-ID, eine GIATA-interne ID für ein spezielles Hotel/Angebot in einem Katalog |
| lang | Nein | nl | Suche nach Angeboten mit angegebener Katalogsprache. |
Diese Parameter dienen nicht direkt der Angebotssuche, beeinflussen aber das Rückgabe-Format.
| Parameter | Benötigt | Beispiel | Kommentar |
|---|---|---|---|
| spa | Nein | 2 | Anzuzeigende Seite, Vorgabe ist Seite 1 |
| ocexact | Nein | 1 | Erzwingt Angebotssuche über exakte Buchungscodesuche (ohne Teilwortsuche) |
| Parameter | Benötigt | Beispiel | Kommentar |
|---|---|---|---|
| show | Ja | txt,pic320,sn | Gibt an, welche Informationen der gefundenen Angebote angezeigt werden sollen. Bei Stammdatenlisten nicht nötig. |
| acount | Nein | 4 | Anzahl Abfragen, nur bei einer genauen Abfrage nach mehreren Angeboten 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 | 5001 | 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 Angebotsdaten, 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 |
| lang | Nein | nl | Suche nach Angebot in einer bestimmten Katalogsprache. Bei "sc=hotel" ist die Angabe des ProviderCode-Parameter "vc=..." erforderlich. |
| Parameter |
Kommentar |
|---|---|
| gid |
GIATAID. Für die Ausgabe der erweiterten GIATA-ID siehe hier. |
| hn |
Angebotsname |
| 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. Wird als Show-Parameter zusätzlich "gid" angegeben, wird die erweiterte GIATA-ID als Attribut ausgegeben, sofern vorhanden. |
| kn |
Katalogname |
| katid |
KatalogID |
| ks |
Nummer der Katalogseite |
| ps |
Nummer der Preisseite (PDF nicht auslieferbar) |
| khid |
GIATA-interne ID für ein spezielles Hotel/Angebot in einem Katalog |
| kst |
Katalogsaison. Mögliche Werte sind: S: Sommerkatalog W: Winterkatalog E: Endloskatalog |
| hk |
Hotelkategorie/Hotelsterne |
| apos |
Anfrageresultat, wichtig für die Mehrfachsuche der Angebotsanzeige. Gibt an welche Suche zu welchem Resultat geführt hat |
| picUHD, picFHD, pic800, pic320, pic150, pic074, pic |
Bilder des Angebots in den maximalen Größen: pic074: 74x74 Pixel pic320: 320x320 Pixel pic150: 150x150 Pixel pic800: 800x600 Pixel picFHD: 1920x1080 Pixel picUHD: 3840x2160 Pixel pics: wie pic320, 320x320 Pixel |
| pics800, pics320, pics150, pics074, pics |
Wie pic800, pic320, pic150, pic074 und pic, nur dass im Falle eines nicht vorhandenen Bildes des Angebotes ein Ersatzbild des Angebots 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 Angebotstext |
| txta |
Textlink zum Angebotstext mit Attribut-Angaben zu Zeichensatz und Sprache |
| text |
Beschreibungstext des Angebots 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 |
|
PDF-Katalog-Seite des Angebots (keine Preisteile). 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 |
| cv |
Links auf Katalogcover in der Größe 70 (70x100), Größe 200 (200x286) und Größe 400 (400x572) |
| cv70 |
Link auf Katalogcover in der Größe 70 (70x100) |
| cv200 |
Link auf Katalogcover in der Größe 200 (200x286) |
| cv400 |
Link auf Katalogcover in der Größe 400 (400x572) Bei dieser Covergröße kann für Kataloge vor dem 03.08.2012 eine verminderter Coverqualität gegeben sein |
| vl |
Link auf Veranstalterlogo in den Größen 20,40,140,288 |
| 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) |
| vl288 |
Link auf Veranstalterlogo in der Größe 288 (288x61) |
| fc |
Existiert Flipcat zum Angebot? 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 Angebots source="catalog": Reiseartbestimmung des Katalogs |
| ttc |
Traveltype (Reiseart) auf Katalogebene. Mögliche Werte sind: P: Pauschalreise H: Hotel - Eigenanreise M: Mixed - gemischte Reisearten U: Unknown - Reiseart unbekannt |
| katcode |
Katalogcode (manchmal auch als Reiseart bekannt, Bsp: CITY, HOTL) |
| 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 die Freischaltung benötigen Sie einen Zusatzvertrag, wenden Sie sich hierfür
bitte an |
| adr |
Adresse des Objekts Für die Freischaltung benötigen Sie einen Zusatzvertrag, wenden Sie sich hierfür
bitte an |
| fact |
Factsheet Für die Freischaltung benötigen Sie einen Zusatzvertrag, wenden Sie sich hierfür
bitte an |
| tds |
Link zum kostenlosen mobilen Reiseführer ios-Reiseführer Auch verfügbar für Android Es wird empfohlen. den tds-Parameter zusammen mit dem khid-Parameter aufzurufen, show=tds,khid,... |
| tp |
Drittanbieterinhalte, siehe hier. Für die Freischaltung benötigen Sie einen Zusatzvertrag, wenden Sie sich hierfür
bitte an |
| vd |
veranstalterunabhängige Videos, siehe hier. Es existiert auch die Möglichkeit eines Listenabrufs. |
| vavideo |
Veranstaltervideos |
| Parameter | Kommentar |
|---|---|
| A | Außenansicht |
| AN | Außenansicht |
| AP | Wohnbeispiel - Apartment |
| AU | Außen/Umgebung ohne Hotel |
| BA | Bar |
| BD | Badezimmer |
| BG | Wohnbeispiel - Bungalow |
| CF | Café |
| EI | Eingang |
| EK | Shopping/Einkaufen |
| ET | Etage/Flur |
| F | Sport und Freizeit |
| FAD | Adventure |
| FO | Folklore |
| FR | Fitness/Wellness |
| FRE | Relax |
| FRR | Frühstücksraum |
| FZ | Familienzimmer |
| GA | Gartenanlage |
| HB | Hallenbad |
| IN | Innenhof |
| IT | Internetcafé |
| K | Konferenzraum |
| KL | Kultur |
| KO | Konferenzraum |
| KU | Kunst |
| L | Lobby/Empfang |
| LG | Logo |
| LK | Landkarte/Karte |
| LO | Lobby |
| LS | Landschaft/Natur |
| LU | Luftaufnahme |
| MF | Mietfahrzeug |
| MHS | Meer / Hafen / Schiff |
| MOD | Modellaufnahme |
| P | Pool |
| PB | Poolbar |
| PE | Personen |
| PEF | Familie |
| PEH | Hochzeit |
| PEK | Kinder |
| PEP | Paar |
| PER | Romance |
| PEY | Party |
| PO | Poolanlage |
| PR | Preis |
| R | Restaurant |
| RE | Restaurant |
| RK | Zimmerküche |
| RV | Zimmerblick |
| RZ | Rezeption |
| S | Strand |
| SB | Strandbar |
| SD | Schiffsdeck |
| SE | Sehenswürdigkeiten |
| SK | Skigebiet |
| SN | Snackbar |
| SP | Sport |
| SR | Seminarraum |
| ST | Strand |
| STA | Stadt(ansicht) |
| SU | Wohnbeispiel/Suite |
| SW | Schwimmbad |
| TE | Terrasse |
| TI | Tier(e) |
| TR | Terrasse |
| TS | Unterhaltung |
| UM | Umgebung |
| W | Wohnbeispiel |
| WBA | Wasseraktivitäten |
| WE | Hotel Standardbild |
| WEL | Wellness |
| X | Sonstiges |
| ZI | Wohnbeispiel/Zimmer |
Für bestimmte Angebotsarten existieren Sammel-IDs, wobei alle Angebote dieser Art über diese Sammel-IDs angesprochen werden können wie z.B. die Angebotsart Ferienhäuser.
Sammel-ID-Liste:
https://xml.giatamedia.com/?sc=list&list=specialid
Eine direkte Suche nach Sammel-Ids ist wegen der möglichen Vielzahl verschiedenster Ergebnisse i.A. nicht sinnvoll, für eine Suche von Angeboten dieser Art ist eine Suchkombination aus Veranstaltercode (vc), Buchungscode (oc) und Kataloggültigkeitszeitraum (date) empfehlenswert.
Die erweiterte GIATA-IDs wird mit der show-Parameter-Kombination "oc,gid" abgerufen und als Attribut "GiataID" im Buchungscode-Element ausgeliefert.
https://xml.giatamedia.com/?show=oc,gid&&oc=QD90A2P
<GiataID isSpecialID="true" isActive="true">102783</GiataID>
<Objectcodes>
<oc seq="1" GiataID="100245463">QD90A2</oc>
<oc seq="2" GiataID="100245754">QD90A2P</oc>
</Objectcodes>
Die Angebotssuche ermöglicht die einfache Suche nach verschiedenen Parametern. Die Angebotssuche ist die Funktion der Wahl, wenn sie z.B. alle Angebote auf Mallorca anzeigen möchten, eine Liste von Angeboten 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 Angebot mit dem Wort "Resort" im Namen:
https://xml.giatamedia.com/?show=hn,vc,vn,txt,pic&sc=search&hn=resort
Suche nach Angeboten auf Mallorca nach DestinationID (ID von Mallorca ist 133, siehe sc=list&list=destination&lc=es):
https://xml.giatamedia.com/?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
https://xml.giatamedia.com/?show=hn,txt,vn,pic074,ln,sn,zn&sc=search&zn=mallorca
Alle Angebote des Kataloges "20110" (GIATA Online Hotels) anzeigen:
https://xml.giatamedia.com/?show=hn,txt,vn,pic074,ln,sn,zn,katid&sc=search&katid=20110
Selbes wie 4), diesmal aber nur alle spanischen Angebote des Kataloges:
https://xml.giatamedia.com/?show=hn,txt,vn,pic074,ln,sn,zn,katid,kn&sc=search&katid=20110&ln=spanien
Alle türkischen Angebote, die bei FTI vorkommen und mind. 4 Sterne haben:
https://xml.giatamedia.com/?show=hn,vn,ln,katid,kn,hk&sc=search&vc=fti&lc=tr&hk=4
Das selbe Beispiel erneut, diesmal aber nur Seite 2 anzeigen:
https://xml.giatamedia.com/?show=hn,vn,ln,katid,kn,hk&sc=search&vc=fti&lc=tr&hk=4&spa=2
Angebote suchen, die im Angebots-Text das Wort "Harley" enthalten
https://xml.giatamedia.com/?show=hn,ln,zn,vc,txt&sc=search&fts=harley
Angebote suchen, die im Angebots-Text das Wort "Harley" und "Sauna" enthalten
https://xml.giatamedia.com/?show=hn,ln,zn,vc,oc,pic320,txt&sc=search&fts=harley,sauna
Angebote suchen, die im Angebot-Text das Wort "Streichelzoo" enthalten und in Österreich liegen
https://xml.giatamedia.com/?show=hn,ln,zn,vc,text&sc=search&fts=streichelzoo&ln=Österreich
Angebote suchen, die im Angebot-Text das Wort "Harley" und vom Veranstalter FTI oder NEC stammen
https://xml.giatamedia.com/?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 andere Angebote zum gefundenen Objekt ausgeben zu lassen, bspw. von anderen Veranstaltern, obwohl das Suchwort eventuell gar nicht im Beschreibungstext eines anderen Veranstalters vorkommt.
Aufruf:
https://xml.giatamedia.com/?show=hn,txt,vn,pic074,ln,sn,zn,katid&sc=search&gid=XXX
Bitte beachten Sie bei den Beispielaufrufen der Angebotssuche:
Die Informationen, die pro Angebot angezeigt werden, hängen vom verwendeten "show" Parameter ab. Um das zu verdeutlichen haben wir den "show"-Parameter bei den Beispielen variiert.
Die Angebotsanzeige ist optimiert auf die Darstellung der Daten eines einzelnen Angebots. Die Angebotsanzeige liefert anders als die Angebotssuche immer nur ein einziges Angebot pro Suchabfrage zurück. Außerdem sind die Suchmöglichkeiten weit geringer als bei der Angebotssuche. Allerdings ist die Angebotsanzeige dafür schneller und erlaubt mehr als eine Suchanfrage gleichzeitig.
Der Umfang der Suchparameter bei "sc=hotel" ist viel geringer als im Angebotssuchmodus "sc=search".
Der Suchparameter Providercode "vc=..." ist erforderlich.
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 Angebots ist sehr einfach.
Abfrage nach dem Veranstalter "FTI", dem Buchungscode "MM059" und der GIATAID 1795:
https://xml.giatamedia.com/?show=hn,vn,ln,katid,kn,hk,pic320&sc=hotel&gid=1795&oc=MM059&vc=fti
Suche nach der GIATAID 5 mit Veranstalter TUI:
https://xml.giatamedia.com/?show=hn,vn,ln,katid,kn,hk,pic320&sc=hotel&gid=5&vc=TUID
Eine Mehrfachabfrage ermöglicht das Abfragen von mehreren Angeboten, 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 Angeboten, deren Buchungscodes und Veranstalter bekannt sind. Um ein Vorschaubild zu zeigen, müssen die Angebotsinformationen für alle z.B. 10 Angebote abgefragt werden. Mit Einzelabfragen würde dies zu lange dauern, daher ist es möglich alle 10 Abfragen gleichzeitig stellen.
Ein schematisches Beispiel mit Platzhaltern (gid_A, vc_A, gid_B, vc_B).
https://xml.giatamedia.com/?sc=hotel&show=apos,hn,vc&acount=2&a[1][gid]=gid_A&a[1][vc]=vc_A&a[2][gid]=gid_B&a[2][vc]=vc_B
Das Ergebnis ist Folgendes:
<result found="2">
<data id="0">
<Anfragenummer>1</Anfragenummer>
<Hotelname>Hotelname 1</Hotelname>
<Veranstaltercode>Veranstalter 1</Veranstaltercode>
</data>
<data id="1">
<Anfragenummer>2</Anfragenummer>
<Hotelname>Hotelname 2</Hotelname>
<Veranstaltercode>Veranstalter 2</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]=gid_A&a[1][vc]=vc_A&a[2][gid]=gid_B&a[2][vc]=vc_B
Die Anzeige wird etwas einfacher, wenn dieser Bereich aufgeschlüsselt wird:
acount = 2 concurrent queries
a query-array
[1] first call (gid_A, vc_A)
vc vc_A Veranstalter vc_A
gid A GIATAID gid_A
[2] second call (gid_B, vc_B)
vc vc_B Veranstalter vc_B
gid B GIATAID gid_B
"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 Angebot 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.
Bei der Buchungscodesuche (oc=string) wird im ersten Schritt eine exakte Suche nach dem übergebenen oc-String durchgeführt. Findet die exakte Suche ein Angebot, ist die Buchungscodesuche beendet. Im ergebnislosen Fall erfolgt in Schritt 2 eine Teilwortsuche vom Buchungscodeanfang her.
Bsp: gesuchter Buchungscode "HRG13010", bei GIATA vorhandener Buchungscode "HRG13010-0539-TS" als Suchtreffer von Schritt 2.
Die exakte Buchungscodesuche ohne Teilwortsuche kann erzwungen werden mit dem Zusatsuchparameter "ocexact=1".
Wird bei den show-Parametern zuätzlich zu "oc" (Buchungscode) noch "gid" (GIATA-ID) verwendet, werden in der Ausgabe des Buchungscode-Tags die erweiterten GIATA-IDs als XML-Attribut "GiataID" mit angezeigt.
Um die weiterte GIATA-ID abzurufen, muss die Show-Parameterkombination "gid,oc" (GIATA-ID und Buchungscode) verwendet werden. Sofern eine erweiterte GIATA-ID vorhanden ist, wird diese als Attribut im Buchungscode-Tag ausgegeben, Beispiel:
<GiataID isSpecialID="true" isActive="true">38297</GiataID> <Objectcode>BRU12090-0009-TF</Objectcode> <Objectcodes> <oc seq="1" GiataID="100227723">BRU12090-0009-TF</oc> </Objectcodes>
HD-Bildlinks werden über den show-Parameter picFHD (Full HD) und picUHD (Ultra HD) abgerufen.
Als HD-Bilder gelten Bilder ab einer Breite von 801 oder ab einer Höhe von 601 Pixel. Full HD-Bilder haben eine maximale Auflösung von 1920x1080 und Ultra HD-Bilder von 3840x2160.
HD-Bildlinks werden nur dann ausgeliefert, wenn das Ursprungsbild ausreichend gross war und haben eine begrenzte Gültigkeit. Die Gültigkeitsdauer beträgt momentan maximal 14 Tage nach Linkauslieferung.
Wird ein Full HD-Bildlink ausgeliefert, ist dieses am Attribut "size=1080" erkennbar, ein Ultra HD-Bild hat das Attribut "size=2160". Beispiel:
https://xml.giatamedia.com/?show=gid,hn,pic150,picFHD,picUHD&khid=9731431
HD-Bildlinks auf dasselbe Bild ändern sich täglich, sind aber innerhalb eines Kalendertages gleich. Als Identifikator wird das Attribut "id" mitgeliefert, das für Bild+Grösse konstant ist.
Das Attribut "comparabilityHash" beschreibt hingegen das Bild unabhängig von der Grösse.
Dieses sind Mediendaten wie z.B. Webcams oder Videos, die von Fremdanbietern zur Verfügung gestellt werden.
Aktuell liegen die Medienarten Webcams und Videos vor.
Es erfolgt die Auslieferung eines Links auf eine HTML-Seite, welche die Webcam enthält
Die Auslieferung erfolgt geocodesbasiert bezugnehmend auf die GIATA-ID des Reiseangebotes. D.h., damit diese Inhalte ausgeliefert werden, müssen diese in einem bestimmten Radius innerhalb der GIATA-ID-Geokoordinaten liegen.
Der Default-Radius ist dabei 15.000 Meter, der GET-Parameter zur Änderung des Radius ist "tpd", die Einheit ist Meter. Weiter ist für die Auslieferung der "show"-Parameter "tp" notwendig.
Abruf und Ausgabe Beispiel mit 5 km Radius:
https://xml.giatamedia.com/?show=gid,tp&gid=237964&tpd=5000
<thirdparty>
<item>
<data>
<url>https://xml.giatamedia.com/extern/thirdparty.php?tp=MTQ5Mjc2NDA1OH...</url>
</data>
<source>
<type id="1">Cam</type>
<supplier id="1">Feratel</supplier>
</source>
<locality>
<distance unit="meter">4622</distance>
<position>Klínovec</position>
<location>Klínovec - Keilberg</location>
<country>Tschechische Republik</country>
<geodata>
<latitude>50.406548</latitude>
<longitude>12.976671</longitude>
</geodata>
</locality>
</item>
Die Videos sind veranstalterunabhängig und basieren auf der GIATA-ID, es erfolgt die Auslieferung eines Links auf eine HTML-Seite, welche das Video enthält. Zusätzlich wird ein Thumbnail für das Video ausgegeben.
Wichtig: Die Video-Links und Thumbnail-Links haben eine zeitlich begrenzte Gültigkeit von 30 Tagen.
Verschiedene Video-Links sind kein hinreichendes Kriterium für verschiedene Videos, Links auf das gleiche Video können verschiedene Hashwerte in der Video-URL enthalten.
Für die Freischaltung benötigen Sie einen Zusatzvertrag, wenden Sie sich hierfür bitte
an <sales@giata.com>.
Abruf-und Ausgabe Beispiel
https://xml.giatamedia.com/?&show=hn,vd&gid=36157
<thirdparty>
<item>
<data duration="97">
<url>https://video.giatamedia.com/?k=MTQ5Mjc2MzMyNH...</url>
<thumbnail>
<url>https://video.giatamedia.com/?k=MTQ5Mjc2MzMyNH...</url>
<url_play_button>https://video.giatamedia.com/?k=MTQ5Mjc2MzMyNH...</url>
</thumbnail>
</data>
<source>
<type id="5">Video</type>
</source>
</item>
Um Autoplay bei Videoaufruf zu starten, wird an die Video-URL der GET-Parameter "&autoplay=1"
angehängt, z.B.
https://video.giatamedia.com/?k=MTQ5Mjc2MzMyNH...&autoplay=1
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
https://xml.giatamedia.com/?sc=list&list=country
Diese Liste kann zusätzlich in englischer Sprache abgerufen werden über den Zusatzparameter "lang=en". Ist kein englischer Content vorhanden, wird ersatzweise der deutsche Content geliefert, was mittels des Attributes "source=de" kenntlich gemacht wird.
Parameter: list=destination
Weitere Parameter: Filterung nach Land mit lc, z.B.: lc=tr. Dieser Parameter ist pflicht.
https://xml.giatamedia.com/?sc=list&list=destination&lc=tr
Diese Liste kann zusätzlich in englischer Sprache abgerufen werden über den Zusatzparameter "lang=en". Ist kein englischer Content vorhanden, wird ersatzweise der deutsche Content geliefert, was mittels des Attributes "source=de" kenntlich gemacht wird.
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 angegeben sein.
https://xml.giatamedia.com/?sc=list&list=city&lc=tr
https://xml.giatamedia.com/?sc=list&list=city&zi=149
Diese Liste kann zusätzlich in englischer Sprache abgerufen werden über den Zusatzparameter "lang=en". Ist kein englischer Content vorhanden, wird ersatzweise der deutsche Content geliefert, was mittels des Attributes "source=de" kenntlich gemacht wird.
Parameter: list=provider
Weitere Parameter: Keine Filter möglich
https://xml.giatamedia.com/?sc=list&list=provider
Parameter: list=catalog
Diese Liste erfordert stets einen zusätzlichen Parameter. Entweder vc="Veranstaltercode" oder lang="Katalogsprache".
https://xml.giatamedia.com/?sc=list&list=catalog&vc=toc
https://xml.giatamedia.com/?sc=list&list=catalog&lang=en
Parameter: list=language
https://xml.giatamedia.com/?sc=list&list=language
Es wird eine Liste mit Giata-Katalog-IDs und den URLs zu den Katalogen im PDF-Format ausgegeben
Parameter: list=pdf
https://xml.giatamedia.com/?sc=list&list=pdf
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)
https://xml.giatamedia.com/?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
Für die Freischaltung benötigen Sie einen Zusatzvertrag, wenden Sie sich hierfür bitte an <
sales@giata.com>.
Ausgabe einer Liste mit Giata-ID und Adressen-Angaben zum Angebot. Einige Adressen im Bestand sind von GIATA noch nicht vollständig verifiziert. Diese erkennen Sie am Attribut kind='unchecked'.
Parameter: list=address
https://xml.giatamedia.com/?sc=list&list=address
Für die Freischaltung benötigen Sie einen Zusatzvertrag, wenden Sie sich hierfür bitte an <
sales@giata.com>.
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]
https://xml.giatamedia.com/?sc=list&list=climate[&lc=countrycode]
Es wird eine Liste mit Giata-IDs und den URLs zu den Videos ausgegeben. Weitere Videoinfo.
Parameter: list=video
Parameter Veranstalterodes "&vc=vc1,vc2...", zeigt nur die Videos an, wo Content der angegebenen Veranstalter vorliegt.
https://xml.giatamedia.com/?sc=list&list=video[&vc=vc1[,vc2...]]
Es wird eine Liste mit Giata-Katalog-IDs und der Infox-Katalog-IDs ausgegeben.
Parameter: list=infox
https://xml.giatamedia.com/?sc=list&list=infox
Sonder/Sammel-IDs bei Giata-IDs
Für bestimmte Angebotsarten existieren Sammel-IDs, wobei alle Angebote dieser Art über diese Sammel-IDs angesprochen werden können wie z.B. die Angebotsart Ferienhäuser. Diese Sammel-IDs können wie folgt abgerufen werden:
Parameter: list=specialid
https://xml.giatamedia.com/?sc=list&list=specialid
Giata-ID-Liste
Es wird eine Liste mit Giata-IDs und dazugehörigem Hotelnamen, Stadtnamen, Zielgebietsnamen und Ländernamen ausgegeben.
Parameter: list=giataid
https://xml.giatamedia.com/?sc=list&list=giataid
Firewall-Server-Liste
Wenn Sie für den XML-Zugriff Freischaltungen in Ihrer Firewall vornehmen müssen, finden sie hier eine 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
https://xml.giatamedia.com/?sc=list&list=firewall
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 https://www.giata.com/service/agb abrufbar.