Content | Create and update Point-Of-Interests (POIs)

Hotels and other POIs can be imported into GUIBO automatically via the API. A common use case is importing hotels from a booking system with the goal of adding the hotels booked for the guest

Hotels are one kind of POIs in GUIBO. They can be created manually in GUIBO, also with the help of Google search and automatic import of data from Google.

1) Create POI

Prerequisite: You have created a library into which the hotels are to be imported. You have given the library a unique ID. In the following example it is the ID "HOTELS".

  • Replace CCCCCC with the customer ID, you can find this under Account Settings > General Settings > Account ID

  • Replace xxxxxx-xxxxxx-xxxxxx-xxxxxx with the API key, you can find this under Account Settings > General Settings > API Key

  • HTL21344 is an exemplaric custom ID of this hotel. With this ID it is easier to update the hotel via the interface.

curl --location --request POST 'https://services.schneidergeo.com/content/geodata/poi' \
--header 'Content-Type: application/json' \
--header 'Authorization: xxxxxx-xxxxxx-xxxxxx-xxxxxx' \
--data-raw '
{
  "account":"CCCCCC",
   "library":{
      "customId":"MY_HOTELS_LIB"
   },
   "customId":"HTL21344",
  "names": {
    "de": "Alpenhotel Kronprinz",
    "en": "Alpenhotel Kronprinz"
  },
  "descriptions": {
    "de": "Unser Partnerhotel in Berchtesgaden",
    "en": "Our partner hotel in Berchtesgaden"
  },
  "lat": 47.62893,
  "lng": 12.99443,
  "icon": "hotel",
  "category": {
    "names": {
      "de": "Unterkunft",
      "en": "Accomodation"
    }
  },
  "attributes": {
    "phone": "+49 8652 6070",
    "web": "https://www.alpenhotel-kronprinz.de/"
  },
   "tags": [
        {
             "names": {
                   "de": "Unterkunft",
                   "en": "Accomodation"
               }
         }
    ]
}
'

Supported Icon Names for POIS:

attention fork hut info location_large parking town water ballsports cablecar_sports climbing crosscountryskiing cycling diving_snorkeling fishing golfing hiking horseriding kitesurfing mountainbiking rowboat sailing skiing surfing swimming windsurfing festival movie museum music theater beach swimming_indoor swimming_outdoor apartment bed_breakfast hotel doctor hospital pharmacy police cablecar_poi castle church generic lake panoramicview peak ruins sight star tosee tourist_info waterfall zoo text destination interimstep stagetown bar coffee deli distillery_winery icecream pub restaurant conveniencestore mall supermarket airport bikerental busstop cablecar_trans camping car carrental ferry parking parkinggarage taxi trainstation vespa

B) Update POI

The update operation uses the same object as the create operation. Just some attributes are ignored and you can leave away:

  • Change of category is ignored. Please use the apropriate endpoint

  • Change of tags is ignored. Please use the apropriate endpoint

  • Change of externalId is ignored.

This example updates the hotel from above with the externen ID "HTL21344".

  • Replace CCCCCC with the customer ID, you can find this under Account Settings > General Settings > Account ID.

  • Replace xxxxxx-xxxxxx-xxxxxx-xxxxxx with the API key, you can find this under Account Settings > General Settings > API Key

curl --location --request PUT 'https://services.schneidergeo.com/content/geodata/poi/CCCCCC/HOTELS/HTL21344' \
--header 'Authorization: xxxxxx-xxxxxx-xxxxxx-xxxxxx' \
--header 'Content-Type: text/plain;charset=UTF-8' \
--data-raw '
{
  "names": {
    "de": "Hotel Post",
    "en": "Hotel Post"
  },
  "descriptions": {
    "de": "Unser Partnerhotel in Salzburg",
    "en": "Our partner hotel in Salzburg"
  },
  "lat": 47.9455079,
  "lng": 12.9364846,
  "icon": "hotel",
  "attributes": {
    "phone": "+43 6272 4422",
    "web": "https://hotelpost.at"
  }
}
'

Last updated