Australian Tourism Data Warehouse

Australian Tourism Data Warehouse

Vector Tile Hosting

Alpaca Travel offers a vector tile hosting service that includes a regularly updated database of ATDW products across Australia. This can be used by users with ATDW Distributor agreements direct with ATDW in order to display a map of all the ATDW products available in their region.

Alpaca travel can help build and provide map tiles in order to create better exploration around your content.

<iframe src="https://codesandbox.io/embed/simple-mapbox-atdw-map-zg4r0q?fontsize=14&hidenavigation=1&theme=dark&module=%2Fsrc%2FMap%2FAtdwMapLayer.tsx" style="width:100%; height:500px; border:0; border-radius: 4px; overflow:hidden;" title="simple-mapbox-atdw-map" ></iframe>

Before you get started, you must add your ATDW API Key to the platform by logging in to your account and adding the ATDW integration.

Interactive Explorer

Alpaca offers an interactive explorer to review what data is visible within the vector dataset.

Interactive Explorer

Feature Specification

Alpaca provides a feature specification that corresponds to commonly used properties that can help you select and style your map accordingly.

Example of Feature Properties

{
  "properties": {
    "id": "5b347afb3e8293ed17072934",
    "num": "AU0170827",
    "org_num": "OR0016918",
    "name": "Hotel Lindrum Melbourne - MGallery",
    "cat": "ACCOMM",
    "class": "[\"HOTEL\"]",
    "maki": "lodging",
    "atts": "[\"COVIDSAFE\",\"ACCOR\",\"24HOURS\",\"BAGROOM\",\"BAR\",\"BUSINESSFC\",\"CONVFAC\",\"NSMOKESTAB\",\"PAYTV\",\"STEREORADIO\",\"RESTAURANT\",\"TOURDESK\",\"FREEWIFI\",\"Luxury\",\"DISTASSIST\"]",
    "rate_from": 265,
    "rate_to": 595,
    "areas": "[\"Melbourne\"]",
    "regions": "[\"Melbourne\"]",
    "suburb": "Melbourne",
    "state_code": "VIC",
    "postcode": "3000",
    "has_deal": false
  }
}

Alpaca also determines a recommended 'maki' icon, which allows you to associate an icon from the maki icon set. Alternatively, you may determine a way to style a symbol in your application based on the cat or class.

Adding to Mapbox

You can directly attach the ATDW products to your Mapbox map instance by adding the following style source definition.

"atdw": {
  "type": "vector",
  "data": "https://mapping.withalpaca.travel/v1/set/atdw.tilejson?scheme=xyz&accessToken=YOUR_ACCESS_TOKEN",
  "scheme": "xyz"
}

Targeting Products

As an example, you can also add a style layer to your map, which will display corresponding ATDW products.

Displaying accommodation throughout Victoria

{
  "id": "vic_accomm",
  "type": "symbol",
  "source": "atdw",
  "source-layer": "default",
  "layout": {
    "icon-image": "{maki}",
    "text-field": ["get", "name"],
    "text-font": ["Open Sans Semibold", "Arial Unicode MS Bold"],
    "text-offset": [0, 1.25],
    "text-anchor": "top"
  },
  "filter": ["all", ["==", "state", "VIC"], ["==", "cat", "ACCOMM"]]
}

Accessing Product Information

You can use the Alpaca Travel GraphQL API documentation which provides you an easy mechanism to access product information from ATDW. This can enable you to present images, opening hours and more about each of the products contained in the ATDW database.

query {
  place(id: "place/atdw:product:5b347afb3e8293ed17072934") {
    # Access information about the business
    name
    address {
      addressLineOne
      addressLineTwo
      addressLineThree
      locality
      region
      regionCode
      country
      countryCode
    }
    contact {
      phoneNumber
      emailAddress
      websiteUrl
      bookingUrl
      facebookUrl
      instagramUrl
      twitterUrl
    }

    # Draw out a thumbnail
    preferredMedia {
      resource {
        ... on MediaImage {
          thumbnail: source(bestFit: [200, 200]) {
            url
          }
          altText
          attribution
        }
      }
    }

    # Include the tracking pixel for you distributor agreement requirements
    attribution {
      pixel
    }

    # Select more about the product, see the documentation how to access any
    # attribute or other information from ATDW
  }
}

If you are building a simple interactive map you can also review using the fetch SDK we offer which can be included with a unpkg script tag and can make calls to the API.

<!DOCTYPE html>
<html>
  <head>
    <!-- Include the script in your head -->
    <script src="https://unpkg.com/@alpaca-travel/graph-sdk-fetch@latest/dist/umd/graph-sdk.min.js"></script>
  </head>

  <body>
    <script type="text/javascript">
      // Update below
      const ACCESS_TOKEN = "UPDATE_WITH_YOUR_ACCESS_TOKEN";

      // Create the SDK
      const sdk = alpacaGraphSdk.getClientSdk({
        url: `https://withalpaca.com/api/graphql?accessToken=${ACCESS_TOKEN}`,
      });

      // Perform a SDK function
      // See the rest of the API Documentation
      // https://alpacatravel.github.io/graph-sdk/packages/fetch/docs/
      sdk
        .getPlace({
          id: "place/atdw:product:5b347afb3e8293ed17072934",
        })
        .then(({ data }) => console.log(data))
        .catch(console.error);
    </script>
  </body>
</html>

See More:

• Alpaca Travel SDK