GIATA XML

GIATA GmbH

Reno Bachor


                        
                    


Inhaltsverzeichnis

1. Changelog (ab 03/2019)
2. Einleitung
3. Authentifizierung
4. Abfrageformen
5. Liste der möglichen Parameter
6. Details der Angebotssuche
7. Details der Angebotsanzeige
8. Details der Listenanzeige

1. Changelog (ab 03/2019)

  • 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")

2. Einleitung

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

3. Authentifizierung

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";
  $remote_url = 'https://xml.giatamedia.com/?show=hn,khid,vc&sc=search&gid=3';

  $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);    

4. Abfrageformen

Für eine effiziente und einfache Abfrage wurde die Schnittstelle in drei Teile zerlegt.

Dies sind im Einzelnen:

Die Angebotssuche:

Sie liefert eine Liste von Angeboten, gefiltert nach Suchparametern wie Angebotsname, Zielgebiet, Veranstalter. Diese Liste kann auf mehrere Seiten aufgeteilt werden.

Die Angebotsanzeige:

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.

Die Listenanzeige:

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: (Benutzername und Password sind hier wie überall in dem Dokument nicht gültig):

https://xml.giatamedia.com/?sc=hotel&show=hn&gid=X

5. Liste der möglichen Parameter

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.

5.1. Allgemeine Parameter

ParameterBenötigtBeispielKommentar
uidJa1345 BenutzerID, wird von GIATA vergeben. Die BenutzerID ist immer eine Zahl.
pwdJaXHdg35 Das Passwort. Ebenso notwendig wie eine BenutzerID. Wird von GIATA vergeben.
scJahotel Art der Suche. Möglich sind: hotel,search,list

5.2. Angebotssuche

ParameterBenötigtBeispielKommentar
showJatxt,pic320,sn Gibt an, welche Informationen des/der gefundenen Angebots angezeigt werden sollen. Bei Stammdatenlisten nicht nötig.
gidNein5001GIATAID
ocNeinGAMASBuchungscode
vcNeintoc [toc, nec] Selektierung eines Veranstaltercodes, wie TOC, NEC, FTI, ADAC.
Bei Abfragen zu Details der Angebotssuche ist auch eine kommaseparierte Liste mehrer Veranstalter möglich.
Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier.
vidNein186 Selektierung einer Veranstalter-ID.
Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier.
katidNein2324 ID des Kataloges, dessen Angebote angezeigt werden sollen. Auch kombinierbar. ID von GIATA vergeben
Die Abfragemöglichkeit einer Katalogliste finden Sie hier.
hnNeinPaloma Angebotsname, oder ein Teil eines Angebotsnamens
hntNeinPaloma 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'
lnNeinspanien Landname, oder ein Teil eines Landnamens.
Eine Abfragemöglichkeit für die Länderliste finden Sie hier.
lcNeintr ISO-Ländercode
Die Abfragemöglichkeit einer Länderliste finden Sie hier.
znNeinmallorca Zielgebietsname, oder ein Teil eines Zielgebietsnamens.
Die Abfragemöglichkeit einer Zielgebietsliste finden Sie hier.
ziNein133 ZielgebietsID/DestinationID, interne Nummer für ein Zielgebiet, von GIATA vergeben
Die Abfragemöglichkeit einer Zielgebietsliste finden Sie hier.
snNeinparis Stadtname, oder ein Teil eines Stadtnamens.
Die Abfragemöglichkeit einer Städteliste finden Sie hier.
siNein132 StadtID/CityID, interne Nummer für eine Stadt, von GIATA vergeben
Die Abfragemöglichkeit einer Städteliste finden Sie hier.
hkNein3 Die kleinste Kategorie, dem das Angebot entsprechen muss
dateNein2008-06-11 Abfrage von Angebotsdaten, die in einer bestimmten Kataloglaufzeit
verfübar sind im Format 'yyyy-mm-dd'
ikatidNeinDERT2AC06 ID des Kataloges bei Infox.
Die Abfragemöglichkeit einer Infox-Kalogliste finden Sie hier.
ftsNeinHarley 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.
khidNein1183641 Suche nach der Kataloghotel-ID, eine GIATA-interne ID für ein spezielles Hotel/Angebot in einem Katalog
langNeinnl Suche nach Angeboten mit angegebener Katalogsprache.

5.3. Angebotssuche Zusatzparameter

Diese Parameter dienen nicht direkt der Angebotssuche, beeinflussen aber das Rückgabe-Format.

ParameterBenötigtBeispielKommentar
spaNein2 Anzuzeigende Seite, Vorgabe ist Seite 1
ocexactNein1 Erzwingt Angebotssuche über exakte Buchungscodesuche (ohne Teilwortsuche)

5.4. Angebotsanzeige

ParameterBenötigtBeispielKommentar
showJatxt,pic320,sn Gibt an, welche Informationen des/der gefundenen Angebots angezeigt werden sollen. Bei Stammdatenlisten nicht nötig.
acountNein4 Anzahl Abfragen, nur bei einer genauen Abfrage nach mehreren Angeboten notwendig
aNeina[0]['vc']=toc Syntax, um mehr als eine Abfrage gleichzeitig durchzuführen.
Acount ist notwendig, nimmt gid, oc und vc auf.
(siehe unten)
gidNein5001GIATAID
ocNeinGAMAS Buchungscode
vcNeintoc Veranstaltercode, wie TOC, NEC, FTI, ADAC
Die Abfragemöglichkeit einer Veranstalterliste finden Sie hier.
stNeinj,s,wGrenzt die Katalogsaison ein
dateNein2008-06-11 Abfrage von Angebotsdaten, die in einer bestimmten Kataloglaufzeit
verfübar sind im Format 'yyyy-mm-dd'
khidNein1183641 Suche nach der Kataloghotel-ID, eine GIATA-interne ID für ein spezielles Hotel/Angebot in einem Katalog
langNeinnl Suche nach Angebot in einer bestimmten Katalogsprache. Bei "sc=hotel" ist die Angabe des ProviderCode-Parameter "vc=..." erforderlich.

5.5. Möglichkeiten des "show"-Parameters

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

Erklärung der Bildtypen im Ergebnis

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

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össe 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 .

Factsheet-Dokumentation

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

5.6. Möglichkeiten der Bildtypen beim Bilderabruf

ParameterKommentar
AAußenaufnahme
BABar
BDBadezimmer
FSport und Freizeit
FADAdventure
FOFolklore
FRERelax
FRRFrühstücksraum
GAGarten
HBHallenbad
ITInternetcafe
KKonferenzraum
KLKultur
KUKunst
LLounge/Empfang
LGLogo
LKLandkarte
LSLandschaft
LULuftaufnahme
MFMietfahrzeug
MHSMeer/Hafen/Schiff
MODModellaufnahme
NANatur
PPool
PEPersonen
PEPPaar
PEFFamilie
PEKKinder
PEHHochzeit
PERRomance
PEYParty
PRPreis
RRestaurant
SStrand
SDSchiffsdeck
SESehenswürdigkeiten
STAStadtansicht
TETerasse
TITiere
WELWellness
WWohnbeispiel
XSonstiges

5.7. 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.

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.

5.8. Erweiterte Giata-IDs

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>

6. Details der Angebotssuche

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.

6.1. Beispielaufrufe für die Angebotssuche

  1. Suche nach einem Angebot mit dem Wort "Resort" im Namen:

    https://xml.giatamedia.com/?show=hn,vc,vn,txt,pic&sc=search&hn=resort

    Anzeige des Ergebnisses

  2. 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

    Anzeige des Ergebnisses

  3. 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

    Anzeige des Ergebnisses

  4. 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

    Anzeige des Ergebnisses

  5. 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

    Anzeige des Ergebnisses

  6. 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

    Anzeige des Ergebnisses

  7. 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

6.2. Beispielaufrufe für die Volltextsuche

  1. Angebote suchen, die im Angebots-Text das Wort "Harley" enthalten

    https://xml.giatamedia.com/?show=hn,ln,zn,vc,txt&sc=search&fts=harley

    Anzeige des Ergebnisses

  2. 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

    Anzeige des Ergebnisses

  3. 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

    Anzeige des Ergebnisses

  4. 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

    Anzeige des Ergebnisses

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.

7. Details der Angebotsanzeige

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:

  1. Veranstaltercode+Buchungscode
  2. Veranstaltergruppe+Buchungscode (NEC Angebote dürfen auch Buchertexte zeigen)
  3. Veranstaltercode+GIATAID
  4. GIATA als Veranstalter + GIATAID

Ist nur ein Teil der Parameter angegeben, wird natürlich auch nur ein Teil der Suchen durchgeführt.

7.1. Ein einzelnes Angebot abfragen

Die Abfrage eines einzelnen Angebots ist sehr einfach.

  1. 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

    Anzeige des Ergebnisses

  2. Suche nach der GIATAID 3400:

    https://xml.giatamedia.com/?show=hn,vn,ln,katid,kn,hk,pic320&sc=hotel&gid=3400

    Anzeige des Ergebnisses

7.2. Mehrere Angebote gleichzeitig abfragen

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.

7.3. Sonder/Sammel-IDs

Eine Suche nach GIATA-IDs, die Sonder/Sammel-IDs sind, ist nicht sinnvoll und sollte mit dem Parameter "sc=search" durchgeführt werden.

7.4. Buchungscodesuche

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.

7.5. Erweiterte GIATA-ID

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>

7.6. Media-Daten

7.6.1. HD-Bilder

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.

7.6.2. Drittanbieterinhalte

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.

7.6.2.1. Webcams

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>

7.6.2.2. Videos

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 .

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

8. Details der Listenanzeige

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.

  1. Länderliste

    Parameter: list=country

    https://xml.giatamedia.com/?sc=list&list=country

    Anzeige des Ergebnisses

    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.

  2. Zielgebietsliste

    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

    Anzeige des Ergebnisses

    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.

  3. Städteliste

    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

    Anzeige des Ergebnisses

    https://xml.giatamedia.com/?sc=list&list=city&zi=149

    Anzeige des Ergebnisses

    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.

  4. Veranstalterliste

    Parameter: list=provider

    Weitere Parameter: Keine Filter möglich

    https://xml.giatamedia.com/?sc=list&list=provider

    Anzeige des Ergebnisses

  5. Katalogliste

    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

    Anzeige des Ergebnisses

  6. Katalogsprachenliste

    Parameter: list=language

    https://xml.giatamedia.com/?sc=list&list=language

  7. PDF-Katalog-Liste

    Es wird eine Liste mit Giata-Katalog-ID's und den URL's zu den Katalogen im PDF-Format ausgegeben

    Parameter: list=pdf

    https://xml.giatamedia.com/?sc=list&list=pdf

  8. Geocodes-Liste

    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 .

  9. Adressen-Liste

    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 .

  10. Klimadaten-Liste

    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]

  11. Video-Liste

    Es wird eine Liste mit Giata-ID's und den URL's 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...]]

  12. Infox-Katalogliste

    Es wird eine Liste mit Giata-Katalog-ID's und der Infox-Katalog-ID's ausgegeben.

    Parameter: list=infox

    https://xml.giatamedia.com/?sc=list&list=infox

  13. 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

  14. 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

  15. 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

    https://xml.giatamedia.com/?sc=list&list=firewall

Für weitere Fragen zu dieser Anleitung können Sie sich jederzeit an Reno Bachor wenden, E-Mail: .

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.

Gesellschaft zur Entwicklung und Vermarktung interaktiver Tourismusanwendungen GmbH

www.giata.com