Content | 3. Point-Of-Interests (POIs)

Hotels and other POIs can be imported into GUIBO automatically via API. A common use case is syncing hotels from a booking system to automatically attach booked accommodations to a guest's guidebook.

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",
  "attributes": {
    "phone": "[phone]",
    "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) Read POI

Use Account ID and Custom ID of Textpage to read the asset.

curl --location --request 'https://services.schneidergeo.com/content/geodata/asset/account/{account}/external/{customId}' \
--header 'Authorization: xxxxxx-xxxxxx-xxxxxx-xxxxxx' \
--header 'Content-Type: application/json' 

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 customId is ignored.

curl --location --request PUT 'https://services.schneidergeo.com/content/geodata/poi' \
--header 'Authorization: xxxxxx-xxxxxx-xxxxxx-xxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '
{
  "account":"CCCCCC",
  "library":{
      "customId":"MY_HOTELS_LIB"
   },
  "customId":"HTL21344",
  "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": "[phone]",
    "web": "https://hotelpost.at"
  }
}
'

C) List POIs in Library

Returns a list of all POIs stored in the specified library.

Note: The response contains lightweight metadata for each POI (such as ID, name, and timestamps), but excludes payloads like images and description. To retrieve full details for a specific POI, fetch it directly using its custom ID.

curl --location 'https://content-tst.guibo.travel/content/library/{account}/{customid}/pois/metadata' \
--header 'Authorization: xxxxxx-xxxxxx-xxxxxx-xxxxxx'

D) Delete POI

Use Account ID and Custom ID of POI to delete the asset. It will be in thrash unless you add the query parameter force=true to the URL.

curl --location --request DELETE 'https://services.schneidergeo.com/content/geodata/account/{account}/external/{customId}' \
--header 'Authorization: xxxxxx-xxxxxx-xxxxxx-xxxxxx' \
--header 'Content-Type: application/json' 

To update other properties of POIs, please have a look at page

Content | 4. Geodata properties