Giter VIP home page Giter VIP logo

tutorials.getting-started's Introduction

FIWARE Banner

FIWARE Core Context Management License: MIT Support badge

These are an Introductory Tutorials to the FIWARE NGSI interfaces. We will start with the data from a supermarket chain’s store finder/Smart Farm and create a very simple “Powered by FIWARE” application by passing in the address and location of each store as context data to the FIWARE context broker.

The tutorial uses cUrl commands throughout, but is also available as Postman documentation.

Start-Up

NGSI-v2 Smart Supermarket

NGSI-v2 offers JSON based interoperability used in individual Smart Systems. To run this tutorial with NGSI-v2, use the NGSI-v2 branch.

git clone https://github.com/FIWARE/tutorials.Getting-Started.git
cd tutorials.Getting-Started
git checkout NGSI-v2

./services create
./services start
NGSI v2
📚 Documentation Postman Collection

NGSI-LD Smart Farm

NGSI-LD offers JSON-LD based interoperability used for Federations and Data Spaces. To run this tutorial with NGSI-LD, use the NGSI-LD branch.

git clone https://github.com/FIWARE/tutorials.Getting-Started.git
cd tutorials.Getting-Started
git checkout NGSI-LD

./services create
./services start
NGSI LD 📚 Documentation Postman Collection

License

MIT © 2018-2024 FIWARE Foundation e.V.

tutorials.getting-started's People

Contributors

actions-user avatar dncampo avatar fisuda avatar fiwarezone avatar jason-fox avatar jmcanterafonseca avatar mapedraza avatar togomezm avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

tutorials.getting-started's Issues

How to provision an IoT Agent

As I've been going through the tutorial (great postman samples btw), I got stuck on how to register an IoT Agent, meaning how do I get/generate tokens etc?

Error when trying to use the `services` command on the NGSI-LD branch

Hi,

I am trying to use the Getting Started guide on the NGSI-LD branch and I have the following error when trying to launch the services:

tutorials.Getting-Started on  NGSI-LD [$]
➜  ./services orion
Stopping containers
Unable to parse logging level: compose

I have the same error when running ./services stop or ./services create.

Any idea?

Use own @context file

Hi,
I tried to replace the ngsi-cintext.jsonld file with my own context file. To do this, I replaced the file in the data-models folder. After starting the service, I tried to query this file at http://localhost:3000/data-models/ngsi-context.jsonld. But here I get the file from the FIWARE tutorial and not my own. It is not clear to me where this file comes from or how to include my own file.
Maybe someone can help me to solve this problem.

Feedback

Yo Jason, here are some initial comments:

  • There should be an installation section:
  1. had to install virtualbox & docker-machine, in addition to docker itself
  2. had to create a default docker machine and connect my shell to the new machine
  3. only then was able to pull mongo and orion
  • I was not able to connect to orion ("curl: (7) Failed to connect to localhost port 1026: Connection refused"), had to change the command to "curl -X GET http://$(docker-machine ip default):1026/version"

  • had to change all the following commands because the localhost or 0.0.0.0 didn't work

  • the outputs of GET commands should be in a json format, but shown in the console as plain text. To get the output shown in the tutorial I had to use the following command:
    "curl -X GET http://$(docker-machine ip default):1026/v2/entities/urn:ngsi-ld:Store:001?options=keyValues | python -m json.tool" (this also doesn't work for all GET commands, no idea why)

  • my output was not UTF-8, but something like "Bornholmer Stra\u00dfe 65". I didn't bother to change it, but probably this should be mentioned.

  • perhaps the parameter/flag -X should be discussed

  • for this command: "curl -X GET http://$(docker-machine ip default):1026/v2/entities?type=Store&georel=near;maxDistance:1500&geometry=point&coords=52.5162,13.3777" I get a confusing output:

[1] 3876
[2] 3877
[3] 3878
-bash: maxDistance:1500: command not found
[4] 3880
[2] Done georel=near
[3] Exit 127 maxDistance:1500
[4]+ Done geometry=point
Filips-MacBook-Air:~ flemic$ [{"id":"urn:ngsi-ld:Store:001","type":"Store","address":{"type":"PostalAddress","value":{"streetAddress":"Bornholmer Straße 65","addressRegion":"Berlin","addressLocality":"Prenzlauer Berg","postalCode":"10439"},"metadata":{}},"location":{"type":"geo:json","value":{"type":"Point","coordinates":[13.3986,52.5547]},"metadata":{}},"name":{"type":"Text","value":"Bösebrücke Einkauf","metadata":{}}},{"id":"urn:ngsi-ld:Store:002","type":"Store","address":{"type":"PostalAddress","value":{"streetAddress":"Friedrichstraße 44","addressRegion":"Berlin","addressLocality":"Kreuzberg","postalCode":"10969"},"metadata":{}},"location":{"type":"geo:json","value":{"type":"Point","coordinates":[13.3903,52.5075]},"metadata":{}},"name":{"type":"Text","value":"Checkpoint Markt","metadata":{}}}]

Cheers!

`services` script does not validate

According to the tutorial the services script can be used to validate data models:

./services validate [file]

However, services contained in this repo does not know this command:

tutorials.NGSI-LD/tutorials.Getting-Started$ ./services validate
Command not Found.
usage: services [create|orion|scorpio|stellio|stellio|stop]

error in barn creation

In the second request (barn creation) of the "Creating Data Entities" section, the option --d has a dash left over. In NGSI-LD branch

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.