Check out the latest documentation.

What's Covered

This tutorial illustrates the basic use of the 51Degrees API. It will show you how to create a provider, how to create a dataset and how to obtain a value for the IsMobile property.

Please note, it is important to remember to delete the match after it has been created in order to free up the resource after use.

Getting Started - Code and Explanation

Getting started example of using 51Degrees Hash Trie device detection. The example shows how to:

  1. Instantiate the 51Degrees device detection provider.

    provider := FiftyOneDegreesPatternV3.NewProvider(dataFile)

  • Produce a match for a single HTTP User-Agent header

    match := provider.GetMatch(userAgent)
  • Extract the value of the IsMobile property

    This example assumes you have the 51Degrees Go Hash Trie API installed correctly.

    Full Source File
    package main
    import (
    // Location of data file.
    var dataFile = "../data/51Degrees-LiteV3.4.trie"
    func main() {
        // User-Agent string of an iPhone mobile device.
        mobileUserAgent := "Mozilla/5.0 (iPhone; CPU iPhone OS 7_1 like Mac OS X) AppleWebKit/537.51.2 (KHTML, like Gecko) 'Version/7.0 Mobile/11D167 Safari/9537.53";
        // User-Agent string of Firefox Web browser version 41 on desktop.
        desktopUserAgent := "Mozilla/5.0 (Windows NT 6.3; WOW64; rv:41.0) Gecko/20100101 Firefox/41.0";
        // User-Agent string of a MediaHub device.
        mediaHubUserAgent := "Mozilla/5.0 (Linux; Android 4.4.2; X7 Quad Core Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/ Safari/537.36";
        // Provides access to device detection functions.
        provider := FiftyOneDegreesTrieV3.NewProvider(dataFile)
        fmt.Println("Starting Getting Started Example.")
        // Carries out a match for a mobile User-Agent.
        fmt.Println("\nMobile User-Agent: ", mobileUserAgent)
        match := provider.GetMatch(mobileUserAgent)
        fmt.Println("   IsMobile: ", match.GetValue("IsMobile"))
        // Carries out a macth for a desktop User-Agent.
        fmt.Println("\nDesktop User-Agent: ", desktopUserAgent)
        match = provider.GetMatch(desktopUserAgent)
        fmt.Println("   IsMobile: ", match.GetValue("IsMobile"))
        // Carries out a match for a MediaHub User-Agent.
        fmt.Println("\nMediaHub User-Agent: ", mediaHubUserAgent)
        match = provider.GetMatch(mediaHubUserAgent)
        fmt.Println("   IsMobile: ", match.GetValue("IsMobile"))
    Full Source File

  • Summary

    In this tutorial you have seen how to use the detector to retrieve the IsMobile property for a pre-defined User-Agent string. The example can easily be modified to retrieve the value of any other property. Premium and Enterprise data files provide considerably more properties such as IsCrawler , PriceBand , HardwareVendor and ScreenInchesWidth . For a full list of properties and the data file versions they exist in please see the Property Dictionary .