MHG - GIATA Multilingual Hotel Guide

GIATA GmbH

Andreas Fünderich

<andreas.fuenderich@giata.de>

$Id: ghgml.xml 513 2016-11-24 14:03:47Z afue $

Inhaltsverzeichnis

1. Authentifizierung

2. Ressourcen

3. Conversion

A. Tabellen

1. Ansichten

Zusammenfassung

Der Webservice wird als REST-Anwendung (REST = REpresentational State Transfer) bereitgestellt.

Dieser Webservice und die dazugehörige Dokumentation werden noch erweitert.

1. Authentifizierung

Der Webservice ist passwortgschützt.

Der Passwortschutz nutzt eine HTTP-Basic-Authentifizierung.

Der Benutzername für Authentifizierung setzt sich zusammen aus dem Benutzernamen (i.d.R. Teil der E-Mail-Adresse vor dem "@") + | (Pipe) + Firmenname.

Für den Testzugang ergibt sich damit folgender Kombination:

Benutzername: testUser|testCompany
Passwort: testPw

2.1. Auflistungen von Objekten

2.1.1. Auflistung aller Objekte

http://ghgml.giatamedia.com/webservice/rest/1.0/items/

Folgende Eingrenzungskriterien stehen zur Verfügung und können als QueryString an den o.g. URI angehängt werden:

country: Das Land als 2-Buchstaben-Code nach ISO 3166-1
destination: Die ID des Zielgebiets in der GIATA-Datenbank
city: Die ID des Orts in der GIATA-Datenbank
changedSince: Liefert nur solche Objekte, die nach dem angegebenen Datum (Format YYYY-MM-DD) geändert wurden

z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/items/?country=ES

http://ghgml.giatamedia.com/webservice/rest/1.0/items/?changedSince=2006-09-01

http://ghgml.giatamedia.com/webservice/rest/1.0/items/?country=ES&changedSince=2006-09-01

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xlink="http://www.w3.org/1999/xlink">
    <items changedSince="2006-09-01" country="ES">
        <item giataId="2272" lastUpdate="2006-09-04T17:13:46+02:00"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/items/2272" />
        <item giataId="2275" lastUpdate="2006-09-04T17:13:46+02:00"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/items/2275" />
        <!-- ... -->
    </items>
</result>

Der Node <items> in <result> kann abhängig von den Eingrenzungskriterien folgende Attribute enthalten:

country: Das Land als 2-Buchstaben-Code nach ISO 3166-1
destination: Die ID des Zielgebiets in der GIATA-Datenbank
city: Die ID des Orts in der GIATA-Datenbank
changedSince: Die Objekte wurden nach dem angegeben Datum (Format YYYY-MM-DD) zuletzt geändert

Jeder Node <item> in <result><items> enthält folgende Attribute:

giataId: Die GIATA-ID
lastUpdate: Datum der letzten Änderung für dieses Objekt nach ISO 8601
xlink:href: Der URI der Einzeldarstellung dieses Objekts

2.1.2. Auflistung aller Objekte mit Texten in einer Sprache

http://ghgml.giatamedia.com/webservice/rest/1.0/texts/*Sprache*/

*Sprache*: 2-Buchstaben-Code nach ISO 639-1

z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en/

Folgende Eingrenzungskriterien stehen zur Verfügung und können als QueryString an den o.g. URI angehängt werden:

country: Das Land als 2-Buchstaben-Code nach ISO 3166-1
destination: Die ID des Zielgebiets in der GIATA-Datenbank
city: Die ID des Orts in der GIATA-Datenbank
changedSince: Liefert nur solche Objekte, die nach dem angegebenen Datum (Format YYYY-MM-DD) geändert wurden

z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en/?country=ES

http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en/?changedSince=2006-09-01

http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en/?country=ES&changedSince=2006-09-01

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xlink="http://www.w3.org/1999/xlink">
    <items lang="en" changedSince="2006-09-01" country="ES">
        <item giataId="2687" lastUpdate="2006-09-04T17:13:46+02:00"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en/2687" />
        <item giataId="3159" lastUpdate="2006-09-04T17:13:21+02:00"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en/3159" />
        <!-- ... -->
    </items>
</result>

Der Node <items> in <result> enthält folgendes Attribut:

lang: Sprache als 2-Buchstaben-Code nach ISO 639-1

Der Node <items> in <result> kann abhängig von den Eingrenzungskriterien folgende Attribute enthalten:

country: Das Land als 2-Buchstaben-Code nach ISO 3166-1
destination: Die ID des Zielgebiets in der GIATA-Datenbank
city: Die ID des Orts in der GIATA-Datenbank
changedSince: Die Objekte wurden nach dem angegeben Datum (Format YYYY-MM-DD) zuletzt geändert

Jeder Node <item> in <result><items> enthält folgende Attribute:

giataId: Die GIATA-ID
lastUpdate: Datum der letzten Änderung für des Textes für dieses Objekt in der gewählten Sprache nach ISO 8601
xlink:href: Der URI zu den Texten in der gewählten Sprache für dieses Objekts

2.1.3. Auflistung aller Objekte mit Bildern

http://ghgml.giatamedia.com/webservice/rest/1.0/images/

Folgende Eingrenzungskriterien stehen zur Verfügung und können als QueryString an den o.g. URI angehängt werden:

country: Das Land als 2-Buchstaben-Code nach ISO 3166-1
destination: Die ID des Zielgebiets in der GIATA-Datenbank
city: Die ID des Orts in der GIATA-Datenbank
changedSince: Liefert nur solche Objekte, die nach dem angegebenen Datum (Format YYYY-MM-DD) geändert wurden

z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/images/?country=ES

http://ghgml.giatamedia.com/webservice/rest/1.0/images/?changedSince=2006-09-01

http://ghgml.giatamedia.com/webservice/rest/1.0/images/?country=ES&changedSince=2006-09-01

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xlink="http://www.w3.org/1999/xlink">
    <items changedSince="2006-09-01" country="ES">
        <item giataId="2275" lastUpdate="2006-08-18T17:06:38+02:00"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275" />
        <item giataId="2284" lastUpdate="2006-08-18T17:06:38+02:00"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2284" />
        <!-- ... -->
    </items>
</result>

Der Node <items> in <result> kann abhängig von den Eingrenzungskriterien folgende Attribute enthalten:

country: Das Land als 2-Buchstaben-Code nach ISO 3166-1
destination: Die ID des Zielgebiets in der GIATA-Datenbank
city: Die ID des Orts in der GIATA-Datenbank
changedSince: Die Objekte wurden nach dem angegeben Datum (Format YYYY-MM-DD) zuletzt geändert

Jeder Node <item> in <result><items> enthält folgende Attribute:

giataId: Die GIATA-ID
lastUpdate: Datum der letzten Änderung eines Bildes für dieses Objekt nach ISO 8601
xlink:href: Der URI zur Auflistung der Bilder für dieses Objekts

2.1.4. Auflistung aller Objekte mit Factsheets

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheets/

Folgende Eingrenzungskriterien stehen zur Verfügung und können als QueryString an den o.g. URI angehängt werden:

country: Das Land als 2-Buchstaben-Code nach ISO 3166-1
destination: Die ID des Zielgebiets in der GIATA-Datenbank
city: Die ID des Orts in der GIATA-Datenbank
changedSince: Liefert nur solche Objekte, die nach dem angegebenen Datum (Format YYYY-MM-DD) geändert wurden

z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheets/?country=ES

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheets/?changedSince=2006-09-01

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheets/?country=ES&changedSince=2006-09-01

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xlink="http://www.w3.org/1999/xlink">
    <items changedSince="2006-09-01" country="ES">
        <item giataId="2275" lastUpdate="2006-12-30T11:41:34+01:00"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/factsheets/2275" />
        <item giataId="2284" lastUpdate="2006-12-30T11:41:34+01:00"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/factsheets/2284" />
        <!-- ... -->
    </items>
</result>

Der Node <items> in <result> kann abhängig von den Eingrenzungskriterien folgende Attribute enthalten:

country: Das Land als 2-Buchstaben-Code nach ISO 3166-1
destination: Die ID des Zielgebiets in der GIATA-Datenbank
city: Die ID des Orts in der GIATA-Datenbank
changedSince: Die Objekte wurden nach dem angegeben Datum (Format YYYY-MM-DD) zuletzt geändert

Jeder Node <item> in <result><items> enthält folgende Attribute:

giataId: Die GIATA-ID
lastUpdate: Datum der letzten Änderung eines Facts für dieses Objekt nach ISO 8601
xlink:href: Der URI zum Factsheet für dieses Objekts

2.1.5. Auflistung mehrerer Objekte mit Details

Um innerhalb einer Auflistung mehrerer Objekte Details (Name, Adresse, Texte, Bilder) zu erhalten, müssen die GIATA-IDs der Objekte bekannt sein.

Eingrenzungskriterien (wie country oder changedSince) stehen dabei nicht zur Verfügung.

Die GIATA-IDs müssen in einer HTTP-POST-Anfrage gesendet werden.

Welche Details ausgeliefert werden, richtet sich nach dem URI, an den die Anfrage gesendet wird.

Name, Adresse, Bilder

http://ghgml.giatamedia.com/webservice/rest/1.0/items

(Abschnitt 2.1.1, „Auflistung aller Objekte“)

Texte

http://ghgml.giatamedia.com/webservice/rest/1.0/texts/*Sprach-Code*

(Abschnitt 2.1.2, „Auflistung aller Objekte mit Texten in einer Sprache“)

Z.B.: http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en

Bilder

http://ghgml.giatamedia.com/webservice/rest/1.0/images

(Abschnitt 2.1.3, „Auflistung aller Objekte mit Bildern“)

Name, Adresse, Texte, Bilder

http://ghgml.giatamedia.com/webservice/rest/1.0/items/*Sprach-Code*

Z.B.: http://ghgml.giatamedia.com/webservice/rest/1.0/items/en

Für den HTTP-POST stehen 2 Möglichkeiten zur Verfügung:

1.

Als URL-codierter HTTP-POST, bei dem die GIATA-IDs als Array in einer Variable giataIds übermittelt werden.

Z.B.:

curl -s --basic -u "*user*|*company*:*password*"
	-d "giataIds[]=2275&giataIds[]=2272"
	"*url*"

2.

Als HTTP-POST, bei dem die Anfrage in einem XML-Dokument gekapselt ist.

Beispiel für das XML-Dokument:

<?xml version="1.0" encoding="UTF-8"?>
<giataIds>
    <giataId>2275</giataId>
    <giataId>2272</giataId>
</giataIds>

Beispiel für den Aufruf:

curl -s --basic -u "*user*|*company*:*password*" 
	-d "<?xml version=\"1.0\" encoding=\"UTF-8\"?><giataIds><giataId>2275</giataId><giataId>2272</giataId></giataIds>"
	"*url*"

Z.B.:

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xlink="http://www.w3.org/1999/xlink"
    xsi:schemaLocation="http://ghgml.giatamedia.com/xsd/1.0/listOfItems.xsd">
    <items>
        <item giataId="2275">
            <!-- 
            BEGIN name, city, country
            http://ghgml.giatamedia.com/webservice/rest/1.0/items/
            http://ghgml.giatamedia.com/webservice/rest/1.0/items/en
             -->
            <name>Melia Alicante</name>
            <city>San Juan</city>
            <country>ES</country>
            <!-- 
            END name, city, country
             -->
            <!-- 
            BEGIN texts
            http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en
            http://ghgml.giatamedia.com/webservice/rest/1.0/items/en
             -->
            <texts>
                <text lastUpdate="2007-04-05T00:10:08+02:00"
                    lang="en">
                    <sections>
                        <section type="100">
                            <title>Location</title>
                            <para>
                                This attractive beach hotel can be found
                                just 100 metres from the centre of San
                                Juans...
                            </para>
                        </section>
                        <section type="101">
                            <title>Facilities</title>
                            <para>
                                Built in 1973, the hotel offers a total
                                of 1150 rooms, of which 5 are suites 54
                                are singles and 486 are doubles...
                            </para>
                        </section>
                        <!-- ... -->
                    </sections>
                </text>
            </texts>
            <!-- 
            END texts
             -->
            <!-- 
            BEGIN images
            http://ghgml.giatamedia.com/webservice/rest/1.0/images
            http://ghgml.giatamedia.com/webservice/rest/1.0/items
            http://ghgml.giatamedia.com/webservice/rest/1.0/items/en
             -->
            <images>
                <image type="a"
                    lastUpdate="2007-06-05T01:56:10+02:00">
                    <sizes>
                        <size maxwidth="74" width="74" height="59"
                            filesize="4729"
                            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14662" />
                        <size maxwidth="320" width="320" height="256"
                            filesize="33044"
                            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14663" />
                        <size maxwidth="800" width="749" height="600"
                            filesize="110853"
                            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14664" />
                    </sizes>
                </image>
                <!-- ... -->
            </images>
            <!-- 
            END images
             -->
        </item>
        <item giataId="2272">
            <!-- ... -->
        </item>
        <!-- ... -->
    </items>
</result>

Das entsprechende XML-Schema finden Sie unter:

http://ghgml.giatamedia.com/xsd/1.0/listOfItems.xsd

Der Node <items> in <result> einhält einen oder mehrere Nodes <item>.

Die Dokumentation der Unter-Abschnitte finden Sie bei den Bescheibungen der entsprechenden Resourcen zu einem einzelnen Objekt:

Abschnitt 2.2.1, „Übersicht aller Resourcen zu einem Objekt“

Abschnitt 2.2.2, „Text zu einem Objekt in einer Sprache“

Abschnitt 2.2.3, „Übersicht der Bilder zu einem Objekt“

2.2. Ansichten zu einzelnen Objekten

2.2.1. Übersicht aller Resourcen zu einem Objekt

http://ghgml.giatamedia.com/webservice/rest/1.0/items/*GIATA-ID*

z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/items/2275

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xlink="http://www.w3.org/1999/xlink"
    xsi:schemaLocation="http://ghgml.giatamedia.com/xsd/1.0/item.xsd">
    <item giataId="2275">
        <name>Melia Alicante</name>
        <street/>
        <city>San Juan</city>
        <country>ES</country>
        <factsheet lastUpdate="2006-12-30T11:41:34+01:00"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/factsheets/2275" />
        <texts>
            <text lastUpdate="2005-10-06T11:55:33+02:00" lang="de"
                xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/texts/de/2275" />
            <text lastUpdate="2005-12-16T20:40:16+01:00" lang="en"
                xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en/2275" />
            <!-- ... -->
        </texts>
        <images>
            <image type="a" lastUpdate="2006-08-18T17:06:38+02:00">
                <sizes>
                    <size maxwidth="74" width="74" height="59" filesize="4729"
                        xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14662" />
                    <size maxwidth="320" width="320" height="256" filesize="33044"
                        xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14663" />
                    <size maxwidth="800" width="749" height="600" filesize="110853"
                        xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14664" />
                </sizes>
            </image>
            <image type="l" lastUpdate="2006-08-18T17:06:38+02:00">
                <sizes>
                    <size maxwidth="74" width="74" height="42" filesize="3617"
                        xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14665" />
                    <!-- ... -->
                </sizes>
            </image>
            <!-- ... -->
        </images>
    </item>
</result>

Das entsprechende XML-Schema finden Sie unter:

http://ghgml.giatamedia.com/xsd/1.0/item.xsd

Der Node <result><item> enthält folgende Nodes:

name

Der Name des Objekts

street

leer

city

Die Stadt

country

Das Land als 2-Buchstaben-Code nach ISO 3166-1

factsheet

Das Attribut xlink:href enthält den URI des Factsheets für dieses Objekt.

texts

Enthält mehrere Nodes vom Typ <text> mit den Attributen lang für die Sprache und xlink:href für den URI des Textes in der entsprechenden Sprache.

images

Enthält mehrere Nodes <image> mit den Attributen type für die Art der Ansicht und lastUpdate für den Zeitpunkt der letzten Änderung.

Jeder Node vom Typ <image><sizes> enthält mehrere Nodes vom Typ <size> mit den maxwidth für die maximale Breite (derzeit 74, 320, 800), width und height für die Bildmaße sowie dem Attribut xlink:href für den URI der Bilddatei.

2.2.2. Text zu einem Objekt in einer Sprache

http://ghgml.giatamedia.com/webservice/rest/1.0/texts/*Sprache*/*GIATA-ID*

z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/texts/en/2275

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ghgml.giatamedia.com/xsd/1.0/itemText.xsd">
    <item giataId="2275">
        <texts>
            <text lastUpdate="2005-12-16T20:40:16+01:00" lang="en">
                <sections>
                    <section type="100">
                        <title>Location</title>
                        <para>
                            This attractive beach hotel...
                        </para>
                    </section>
                    <section type="101">
                        <title>Facilities</title>
                        <para>
                            Built in 1973, the hotel offers a total of
                            1150 rooms...
                        </para>
                    </section>
                    <!-- ... -->
                </sections>
            </text>
        </texts>
    </item>
</result>

Das entsprechende XML-Schema finden Sie unter:

http://ghgml.giatamedia.com/xsd/1.0/itemText.xsd

Der Node <result><item><texts><text><section> enthält mehrere Nodes vom Typ <section>:

Jeder Node vom Typ <section> entspricht einem Sinnabschnitt und enthält jeweils zwei Nodes:

title: Die Überschrift
para: Der Fließtext dieses Abschnitts

Der Wert des Attributs type bezeichnet die Art des Sinnabschnitts und kann verwendet werden, um eigene Überschriften zu verwenden.

2.2.3. Übersicht der Bilder zu einem Objekt

http://ghgml.giatamedia.com/webservice/rest/1.0/images/*GIATA-ID*

z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xlink="http://www.w3.org/1999/xlink"
    xsi:schemaLocation="http://ghgml.giatamedia.com/xsd/1.0/itemImage.xsd">
    <item giataId="2275">
        <images>
            <image type="a" lastUpdate="2006-08-18T17:06:38+02:00">
                <sizes>
                    <size maxwidth="74" width="74" height="59" filesize="4729"
                        xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14662" />
                    <size maxwidth="320" width="320" height="256" filesize="33044"
                        xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14663" />
                    <size maxwidth="800" width="749" height="600" filesize="110853"
                        xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/images/2275/14664" />
                </sizes>
            </image>
            <!-- ... -->
        </images>
    </item>
</result>

Das entsprechende XML-Schema finden Sie unter:

http://ghgml.giatamedia.com/xsd/1.0/itemImage.xsd

Der Node <result><item><images> enthält mehrere Nodes vom Typ <image>:

Jeder Node vom Typ <image> enthält die Attribute type für die Art der Ansicht und lastUpdate für den Zeitpunkt der letzten Änderung.

Jeder Node vom Typ <image> mehrere Nodes vom Typ <sizes><size> mit den Attributen maxwidth für die maximale Breite (derzeit 74, 320, 800), width und height für die Bildmaße sowie dem Attribut xlink:href für den URI der Bilddatei.

2.2.4. Factsheet zu einem Objekt

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheets/*GIATA-ID*

z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheets/3183

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ghgml.giatamedia.com/xsd/1.0/itemFactSheet.xsd">
    <item giataId="2817">
        <name>Orquidea Bahia Feliz</name>
        <street/>
        <city>Bahia Feliz</city>
        <country>ES</country>
        <factsheet lastUpdate="2006-12-30T11:41:34+01:00">
            <sections>
                <section type="1001" name="object_information">
                    <facts>
                        <fact id="3" name="hotel_chain"
                            typeHint="string">
                            <value>HOTET</value>
                        </fact>
                        <fact id="6" name="postcode"
                            typeHint="string">
                            <value>35107</value>
                        </fact>
                        <fact id="8" name="phone_reservation"
                            typeHint="string">
                            <value>928157240</value>
                        </fact>
                        <!-- ... -->
                    </facts>
                </section>
                <!-- ... -->
                <section type="1006" name="beach">
                    <facts>
                        <fact id="59" name="beach_sandy"
                            typeHint="bool">
                            <value>true</value>
                        </fact>
                        <fact id="62" name="beach_sunloungers"
                            typeHint="bool">
                            <value fee="true">true</value>
                        </fact>
                        <!-- ... -->
                    </facts>
                </section>
                <!-- ... -->
                <section type="1011" name="distances">
                    <facts>
                        <fact id="1001" name="dist_city_centre"
                            typeHint="int">
                            <value name="distance" unit="m">700</value>
                        </fact>
                        <fact id="1002" name="dist_tourist_centre"
                            typeHint="int">
                            <value name="distance" unit="m">4000</value>
                        </fact>
                        <!-- ... -->
                    </facts>
                </section>
                
            </sections>
        </factsheet>
    </item>
</result>

Das entsprechende XML-Schema finden Sie unter:

http://ghgml.giatamedia.com/xsd/1.0/itemFactSheet.xsd

Der Node <result><item> enthält folgende Nodes:

name

Der Name des Objekts

street

leer

city

Die Stadt

country

Das Land als 2-Buchstaben-Code nach ISO 3166-1

factsheet

Das Factsheet zu dem Objekt, mit einem Attribut lastUpdate für den Zeitpunkt der letzten Änderung

Enthält einen Node vom Typ <sections> mit mehreren Nodes vom Typ <section>.

Jeder Node vom Typ <section> beschreibt eine Gruppe von Facts und enthält folgende Attribute:

type: Ein unveränderlicher integer-Wert zur Identifizierung der Gruppe von Facts, s. Factsheet-Definitionen
name: Eine Bezeichnung der Gruppe von Facts, s. Factsheet-Definitionen

Jeder Node vom Typ <section> enthält einen Node vom Typ <facts> mit mehreren Nodes vom Typ <fact>

Jeder Node vom Typ <fact> beschreibt ein Fact und enthält folgende Attribute:

id

Einen unveränderlichen integer-Wert zur Identifizierung des Facts, s. Factsheet-Definitionen

name

Eine Bezeichnung des Facts, s. Factsheet-Definitionen

typeHint

Gibt den Typ der Werte des Facts an.

Mögliche Werte sind:

bool: Wahrheitswert

int: Ganzzahl

float: Fließkommazahl

string: Text

Jeder Node vom Typ <fact> enthält einen oder mehreren Nodes vom Type <value> mit den Werten des Facts:

Folgende Attribute sind möglich:

fee

Gibt an, ob eine Gebühr anfällt; relevant, wenn ein Fact eine Leistung beschreibt

dummy

Kennzeichnet den Wert als Test-Wert, der vom tatsächlichen Wert abweichen kann

name

Dient zur Identfikation des Werts, wenn ein Fact mehrere Werte haben kann

unit

Gibt die Einheit des Wertes des Facts, wenn sich diese nicht aus der Art des Wertes ergibt.

Mögliche Werte sind:

m: Meter

min: Minuten

2.3. Hilfestellungen

2.3.1. Factsheet-Definitionen

2.3.1.1. Auflistung der Sprachen, für die Übersetzungen der Factsheet-Definitionen vorliegen

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xlink="http://www.w3.org/1999/xlink">
    <languages>
        <!-- ... -->
        <factdefinitions lang="de"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/de" />
        <factdefinitions lang="en"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/en" />
        <factdefinitions lang="en-US"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/en-US" />
        <factdefinitions lang="es"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/es" />
        <factdefinitions lang="es-419"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/es-419" />
        <!-- ... -->
        <factdefinitions lang="zh-cmn-Hans"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/zh-cmn-Hans" />
        <!-- ... -->
    </languages>
</result>

Der Node <result><languages> enthält mehrere Nodes vom Typ <factdefinitions> mit folgenden Attributen:

lang: Sprache nach ISO 639-1 bzw. RFC 4646, sofern es sich um eine Sprachvariante handelt
xlink:href: Der URI der Übersetzung der Factsheet-Definitionen in dieser Sprache

2.3.1.2. Factsheet-Definitionen und -Übersetzungen in einer Sprache

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/*Sprache*/

Sprache: Sprache nach ISO 639-1 bzw. RFC 4646, sofern es sich um eine Sprachvariante handelt

z.B. deutsch:

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/de

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <factdefinitions lang="de">
        <sections>
            <section type="1001" name="object_information">
                <title>Objekt-Informationen</title>
                <facts>
                    <fact id="3" name="hotel_chain" typeHint="string">
                        <title>Hotelkette</title>
                    </fact>
                    <fact id="6" name="postcode" typeHint="string">
                        <title>Post-Code</title>
                    </fact>
                    <fact id="8" name="phone_reservation"
                        typeHint="string">
                        <title>Telefon Empfang</title>
                    </fact>
                    <!-- ... -->
                </facts>
            </section>
            <!-- ... -->
            <section type="1006" name="beach">
                <title>Strand</title>
                <facts>
                    <fact id="59" name="beach_sandy" typeHint="bool">
                        <title>Sandstrand</title>
                    </fact>
                    <!-- ... -->
                    <fact id="62" name="beach_sunloungers"
                        typeHint="bool">
                        <title>Liegestühle</title>
                    </fact>
                    <!-- ... -->
                </facts>
            </section>
            <!-- ... -->
            <section type="1011" name="distances">
                <title>Entfernungen</title>
                <facts>
                    <fact id="1001" name="dist_city_centre" typeHint="int">
                        <title>Stadtzentrum</title>
                    </fact>
                    <fact id="1002" name="dist_tourist_centre" typeHint="int">
                        <title>Touristenzentrum</title>
                    </fact>
                    <!-- ... -->
                </facts>
            </section>
        </sections>
    </factdefinitions>
</result>

z.B. englisch:

http://ghgml.giatamedia.com/webservice/rest/1.0/factsheetdefinitions/en

<?xml version="1.0" encoding="UTF-8"?>
<result>
    <factdefinitions lang="en">
        <sections>
            <section type="1001" name="object_information">
                <title>Object Information</title>
                <facts>
                    <fact id="3" name="hotel_chain" typeHint="string">
                        <title>Hotel Chain</title>
                    </fact>
                    <fact id="6" name="postcode" typeHint="string">
                        <title>Postcode</title>
                    </fact>
                    <fact id="8" name="phone_reservation"
                        typeHint="string">
                        <title>Telephone Reservation</title>
                    </fact>
                    <!-- ... -->
                </facts>
            </section>
            <!-- ... -->
            <section type="1006" name="beach">
                <title>Beach</title>
                <facts>
                    <fact id="59" name="beach_sandy" typeHint="bool">
                        <title>Sandy Beach</title>
                    </fact>
                    <!-- ... -->
                    <fact id="62" name="beach_sunloungers"
                        typeHint="bool">
                        <title>Sun loungers</title>
                    </fact>
                    <!-- ... -->
                </facts>
            </section>
            <!-- ... -->
            <section type="1011" name="distances">
                <title>Distances</title>
                <facts>
                    <fact id="1001" name="dist_city_centre" typeHint="int">
                        <title>City Centre</title>
                    </fact>
                    <fact id="1002" name="dist_tourist_centre" typeHint="int">
                        <title>Tourist Centre</title>
                    </fact>
                    <!-- ... -->
                </facts>
            </section>
        </sections>
    </factdefinitions>
</result>

Der Node <result><factsheetdefinitions> hat als Attribut lang die gewählte Sprache und enthält einen Node vom Typ <sections> mit mehreren Nodes vom Typ <section>.

Jeder Node vom Typ <section> beschreibt eine Gruppe von Facts und enthält folgende Attribute:

type: Ein unveränderlicher integer-Wert zur Identifizierung der Gruppe von Facts
name: Eine Bezeichnung der Gruppe von Facts

Jeder Node vom Typ <section> enthält einen Node vom Typ <title> mit der Übersetzung für die Gruppe von Facts in der gewählten Sprache als Wert.

Jeder Node vom Typ <section> enthält einen Node vom Typ <facts> mit mehreren Nodes vom Typ <fact>.

Jeder Node vom Typ <fact> beschreibt ein Fact und enthält folgende Attribute:

id

Ein unveränderlicher integer-Wert zur Identifizierung des Facts

name

Eine Bezeichnung des Facts

typeHint

Gibt den Typ der Werte des Facts an.

Mögliche Werte sind:

bool: Wahrheitswert

int: Ganzzahl

float: Fließkommezahl

string: Text

Jeder Node vom Typ <fact> enthält einen Node vom Typ <title> mit der Übersetzung des Facts in der gewählten Sprache als Wert.

2.3.2. Mappings

Für die Freischaltung benötigen Sie einen Zusatzvertrag, wenden Sie sich hierfür bitte an <service@giata.de>.

2.3.2.1. Auflistung von Anbietern

http://ghgml.giatamedia.com/webservice/rest/1.0/mappings/

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xlink="http://www.w3.org/1999/xlink">
    <mappings>
        <mapping supplier="hotelbeds"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/mappings/hotelbeds" />
        <mapping supplier="tourico"
            xlink:href="http://ghgml.giatamedia.com/webservice/rest/1.0/mappings/tourico" />
        <!-- ... -->
    </mappings>
</result>

Der Node <result><mappings> enthält mehrere Nodes vom Typ <mapping> mit folgenden Attributen:

supplier: Der Name des Anbieters, dessen Objekts-Codes zu den GIATA-IDs in MHG gemappt wurde
xlink:href: Der URI des Mappings von GIATA-IDs zu den Objekts-Codes des Anbieters

2.3.2.2. Mapping

http://ghgml.giatamedia.com/webservice/rest/1.0/mappings/*Name des Anbieters*

Z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/mappings/tourico

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ghgml.giatamedia.com/xsd/1.0/mapping.xsd">
    <items supplier="tourico">
        <!-- ... -->
        <item giataId="1399">
            <code>
                <value>1038976</value>
            </code>
        </item>
        <item giataId="1410">
            <code>
                <value>13806</value>
            </code>
        </item>
        <item giataId="1411">
            <code>
                <value>1035278</value>
            </code>
            <code>
                <value>13797</value>
            </code>
        </item>
        <!-- ... -->
    </items>
</result>

Das entsprechende XML-Schema finden Sie unter:

http://ghgml.giatamedia.com/xsd/1.0/mapping.xsd

Der Node <result><items> hat das Attribut supplier mit den Namen des Anbieters und enthält mehrere Nodes vom Typ <item>.

Jeder Node vom Typ <item> hat das Attribut giataId für die GIATA-ID und enthält einen oder mehrere Nodes vom Typ <code>.

Jeder Node vom Typ <code> enthält einen oder mehrere Nodes vom Typ <value>. <value> wird mehrfach auftreten, wenn der Code des Anbieters für das Objekt aufgeteilt ist, z.B. in Hotel-Kette und Hotel-ID.

Jeder Node vom Typ <value> kann das Attribut name enthalten, z.B. Hotel-Kette oder Hotel-ID.

2.3.2.3. Mapping zu einem Objekt

Sie können das Mapping zu einem Objekt anhand des Namens des Anbieters und des Codes des Objekts abfragen. Es werden dann alle bekannten Codes der verschiedenen Anbieter (Abschnitt 2.3.2.1, „Auflistung von Anbietern“) zurückgeliefert.

http://ghgml.giatamedia.com/webservice/rest/1.0/mappings/*Name des Anbieters*/*Code des Objekts*

Z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/mappings/tourico/1038976

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ghgml.giatamedia.com/xsd/1.0/mappings.xsd">
    <items supplier="tourico" id="1038976">
        <item giataId="1399">
            <name>Holiday Inn Golden Mile</name>
            <city>Kowloon - Hongkong</city>
            <country>CN</country>
            <code supplier="hotelbeds">
                <value>69601</value>
            </code>
            <code supplier="tourico">
                <value>1038976</value>
            </code>
            <code supplier="pegs">
                <value name="Chain Code">HI</value>
                <value name="Property Code">HKGKL</value>
            </code>
        </item>
    </items>
</result>

Das entsprechende XML-Schema finden Sie unter:

http://ghgml.giatamedia.com/xsd/1.0/mappings.xsd

Der Node <result><items> hat die Attribute supplier mit den Namen des Anbieters und id mit dem Code des Objekts bei diesem Anbieter; er enthält einen oder mehrere Nodes vom Typ <item>.

Jeder Node vom Typ <item> hat das Attribut giataId für die GIATA-ID und kann die Nodes <name>, <city>, <street> und <country> zur Identifizierung des Objekts enthalten.

Jeder Node vom Typ <item> enthält zudem enthält einen oder mehrere Nodes vom Typ <code>.

Jeder Node vom Typ <value> kann das Attribut name enthalten, z.B. Hotel-Kette oder Hotel-ID.

Das Mapping kann auch anhand der GIATA-ID erfolgen, also:

http://ghgml.giatamedia.com/webservice/rest/1.0/mappings/giata/1399

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ghgml.giatamedia.com/xsd/1.0/mappings.xsd">
    <items supplier="giata" id="1399">
        <item giataId="1399">
            <name>Holiday Inn Golden Mile</name>
            <city>Kowloon - Hongkong</city>
            <country>CN</country>
            <code supplier="hotelbeds">
                <value>69601</value>
            </code>
            <code supplier="tourico">
                <value>1038976</value>
            </code>
            <code supplier="pegs">
                <value name="Chain Code">HI</value>
                <value name="Property Code">HKGKL</value>
            </code>
        </item>
    </items>
</result>

In einigen Fällen wird die Anfrage zu keinem Ergebnis führen.

Dies kann daran liegen, dass nach einem zusammengesetzten Code gesucht wurde.

Fassen Sie in einem solchen Fall die Bestandteile (z.B. Hotelkette und Hotel-Code oder Länder-Code, Destination-Code und Hotel-Code) ohne Trennzeichen zu einer Zeichenkette zusammen. Z.B.:

http://ghgml.giatamedia.com/webservice/rest/1.0/mappings/pegs/HIHKGKL

<?xml version="1.0" encoding="UTF-8"?>
<result xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ghgml.giatamedia.com/xsd/1.0/mappings.xsd">
    <items supplier="pegs" id="HIHKGKL">
        <item giataId="1399">
            <name>Holiday Inn Golden Mile</name>
            <city>Kowloon - Hongkong</city>
            <country>CN</country>
            <code supplier="hotelbeds">
                <value>69601</value>
            </code>
            <code supplier="tourico">
                <value>1038976</value>
            </code>
            <code supplier="pegs">
                <value name="Chain Code">HI</value>
                <value name="Property Code">HKGKL</value>
            </code>
        </item>
    </items>
</result>

3. Conversion

Für die Integration der gif-Datei zur Mitteilung erfolgter Buchungen (§7.a des Lizenzvertrags) wird Ihnen Beispiel-Code von GIATA zur Verfügung gestellt.

A. Tabellen

1. Ansichten

type	Art der Ansicht
a	Aussenansicht
ba	Bar
f	Sport/Freizeit
k	Konferenz
l	Lobby
p	Pool
r	Restaurant
s	Strand
t	Terasse
w	Wohnbeispiel