Start-Up Guide for BIG IoT Consumer Developers

Step-by-step Instructions

What you will need

  • Basic Java experience
  • Git (e.g. Git-SCM, see here at
  • A Google or GitHub Account - to authenticate on the Marketplace
  • An IDE for Java Development (e.g. Eclipse) or simply a text editor :smiley:

1. Step: Login on Marketplace

  • Select the BIG IoT Marketplace you want to use:
    • Public BIG IoT Marketplace URI:
      • Here you find our BIG IoT data Offerings. You can also provide your Offerings here.
  • Click on Login
  • You can use your GitHub or Google account to sign in

2. Step: Create new Organization on Marketplace

  • The first time you login on the Marketplace with your account, you can create a new Organization
  • Click on New Organization (see bottom left)
  • Enter a name for your new Organization

3. Step: Create new Consumer instance

  • Click on MyConsumers
  • Click on +Consumer
  • Enter a name for your new Consumer instance (e.g. “SmartCityDashboard”)

4. Step: Find Offerings

Create a new Offering Query

  • Click on MyConsumers and select your new Consumer instance
  • Click on +OfferingQuery and give your OfferingQuery a name
  • Define a semantic Category (and if applicable also sub-categories)
  • Optionally: define a Region, a Time Period, a License, a Price, etc.
  • Save the OfferingQuery
  • Scroll down - to the bottom of your OfferingQuery. There you will see all the matching Offerings
    • NOTE: You might need to refresh your browser or reload the page to get the update
  • Explore the Offerings

5. Download Java Template Project

git clone

6. Import the Project into your IDE

  • For Eclipse IDE:
    • Go to File -> Import -> Gradle Project
      • NOTE: If you don’t see the Gradle Project import option, you first have to install the Eclipse gradle tooling (buildship) - see here for further information
    • Select the consumer template project directory: /big-iot/java-template-consumer
    • Import the project

7. Update Properties Files

Update your Consumer ID and Secret in the file (see root directory of the template project)

NOTE: You can copy the Consumer ID and SECRET directly from the Marketplace Web Portal (e.g. Open it in the Browser, Log In and then click on Copy ID to Clipboard (see top right) for your Consumer ID or Load Consumer Secret followed by Copy Secret to Clipbard for your Consumer Secret.

8. Edit the Example Consumer Java application

  • Open the Example Consumer Java source file: ./src/main/java/org/bigiot/examples/
  • Update the Offering ID here:
    consumer.subscribeByOfferingId("... include the Offering ID that you want to subscribe to and access ...").get();

NOTE: You can copy an Offering ID when you open the Offering on the Web Portal, and then click on Copy ID to Clipboard (see top right).

9. Run the Consumer application

  • From the command line: Use ./gradlew run in the root directoy of the project
  • From Eclipse IDE: Go to Run -> Run and then select your consumer application

Developer Guide

How to develop a BIG IoT Consumer?

  • A detailed developer tutorial for a Consumer can be found here

  • Simple Consumer example for accessing a known Offering (full example code is available here):

// Initialize Consumer with Consumer ID and marketplace URL
Consumer consumer = new Consumer("Your Consumer ID - get it from Marketplace", "")
       .authenticate("Your Consumer SECRET - get it from Marketplace");

// Subscribe to Offering by OfferingId
Offering offering = consumer.subscribeByOfferingId("OfferingId - find it on Marketplace").get();

// Define Input Data as access parameters
AccessParameters accessParameters = AccessParameters.create();
       // e.g. .addRdfTypeValue("schema:latitude", 42.0).addRdfTypeValue("schema:longitude", 9.0);

// Access Offering one-time with Access Parameters (input data) --> response includes JSON results
AccessResponse response = offering.accessOneTime(accessParameters).get();

Download SDK

Information on how to download and use our SDK directly in your project is provided here.

Background Information

Background information and details on the BIG IoT architecture and vision are available here.