Package: jason-gnss
Python SDK for Jason GNSS Cloud PPK ServiceJason GNSS Cloud PPK Serviceis a cloud-based
positioning engine that uses GNSS data. One of the main features of this service
is that offers an API so that users can automatize the GNSS data processing
without the need to access the front-end.The online documentation of the service can be foundhere.To install the package:pip3installjason-gnssNote that this SDK supports only Python 3.x.AuthenticationIt is important that you have theJASON_API_KEYandJASON_SECRET_TOKENenvironement variables. These can be fetched by accessing your area in the
Jason PaaS and then going toMy Account->API Credentials.Use the package as an SDKThe package is basically a library that can be embedded into your Python scriptsimportjason_gnssasjason# Submit a process without waiting for it to finish (fetch it later)jason.submit_process(rover_file)# ({'message': 'success', 'id': 3505}, 200)# Get the status of your process. The documentation of the return can# be found in the Jason online documentationprocess_id=3505jason.get_status(process_id)# ({'process': {'id': 3505, ...}, 200)# Download the results file for a given process that you ownjason.download_results(process_id)# '/jason_gnss/rokubun_gnss_id_003505.zip'Command line toolsThe package has also a command line tool so that you can use it out-of-the-box.
The following examples illustrate how to use it.exportJASON_API_KEY='<jason-api-key>'exportJASON_SECRET_TOKEN='<your-private-jason-user-token>'# Get the helpjason-h# Process a rover filejasonprocesstest/jason_gnss_test_file_rover.txt# Process a rover file and adding a base station file as welljasonprocesstest/jason_gnss_test_file_rover.txttest/jason_gnss_test_file_base.txt# Perform a PPK processing specifying a rover, base file as well as the location# of the base stationjasonprocesstest/jason_gnss_test_file_rover.txt\test/jason_gnss_test_file_base.txt\--base_position41.8091428042.163228514936.01730# Get the status of a processjasonstatusprocess_id# Fetch the results file for a given process idjasondownloadprocess_id# Convert a file to RINEX 3.03 formatjasonconverttest/jason_gnss_test_file_smartphone.txtThe arguments of the command line tools follow thedocoptDocker execution/developmentIt is recommended that you use docker to execute or work with this package.
This repository contains both aDockerfileas well as adocker-compose.ymlto help you with this.Follow these instructions:# Command to build the imagedocker-composebuild# Start the container with the package loaded with the commanddocker-composerunjason_gnssOnce inside the container:# Install the packagepythonsetup.pyinstallNow, while in the container, you can issue commands in the prompt or
within the Python console.API Key and secret tokenIf you are using docker-compose, we recommend that you store your authorization
keys in a file.envand run the Docker container via the commanddocker-compose run jason-gnss. With this, your credentials will be loaded
in the container and the Jason tools will be ready to use without the need
to declare these variables.JASON_API_KEY='<jason-api-key>'
JASON_SECRET_TOKEN='<your-private-jason-user-token>'Although probably not used for the end user, for debugging purposes, in the
event that you have a local instance of the Jason service running in your
facilities, you can set the Jason entry point by defining theJASON_API_URLenvironment variable.