This guide helps the users to visualize the collected geodata uploaded on ODK Aggregate server. There are various options you can choose from, like Google Fusion Tables and Google Earth.
Tip
- If you're looking to do some quick visualizations of a small dataset and aren't too worried about the inherent risks of experimental tools, then you should use :ref:`Google Fusion Tables <use-google-fusion>`.
- If you're serious about the long-term use of geodata and have large dataset use :ref:`Google Earth <use-google-earth>`.
Prerequisites
- Make sure you have set up your :doc:`ODK Aggregate server <aggregate-install>`.
- You should know how :doc:`ODK Collect <collect-guide>` works.
- You should be familiar with form designers like :doc:`ODK Build <odk-build>`, :doc:`XLSForm <xlsform>` to create your location based forms and upload it to ODK Aggregate server.
:dfn:`Google Fusion Tables` is an experimental data visualization web application provided by Google for data management. Fusion tables can be used for visualizing dataset on a map.
Follow these steps to view your data using fusion tables:
- Login to your ODK Aggregate server.
- In the :guilabel:`Submissions` tab, under :guilabel:`Filter Submissions`, select the form you want to use.
- If you are using Google Cloud Platform make sure you have enabled relevant APIs like Google Drive API, Fusion Tables API, and Google Maps Javascript API otherwise you may get RequestFailureException error.
- To enable the APIs go to Google Cloud Platform and click on :guilabel:`Console` in the top right corner. Click on the three horizontal bars in the top left corner, now select :guilabel:`APIs & services` from the menu and then select :guilabel:`Library` option.
- You will be able to see the API Library page.
- Search the APIs in the search bar.
- Click on :guilabel:`Enable`.
- Now return to ODK Aggregate server and click on the :guilabel:`Publish` button.
- In :guilabel:`Publish to` field, choose the platform from the drop-down menu to which you want to publish your data, choose Google Fusion Tables. In the :guilabel:`Data to Publish` field, Select the option from the drop-down menu to define what you want to upload:
- :guilabel:`Upload Existing Submission Data Only` will only upload the existing data you already have submitted to your ODK Aggregate server.
- :guilabel:`Stream New Submission Data Only` can be used if you want new submissions to be automatically entered into Google Fusion Tables.
- :guilabel:`BOTH Upload Existing and Stream New Submission Data` will upload your existing submissions into Fusion Tables and continue automatically adding new submissions to your table.
Choose :guilabel:`BOTH Upload Existing and Stream New Submission Data` and click on :guilabel:`Publish`.
Tip
If you choose :guilabel:`BOTH Upload Existing and Stream New Submission Data` option, you would be able to create a link between your data in Google Earth and Google Fusion Tables, for more information, refer this link.
- You will need to enter an email address and that email address will be granted access to the documents.
- Check the inbox of the email address that you entered and there would be an email from odk-oauth2-publishing, click on :guilabel:`Open`.
- After clicking on :guilabel:`Open` you would be redirected to Google Fusion tables website. Here you would be able to see your submissions.
- Select :guilabel:`Map of location` and you should see your data points displayed on a Google Map.
Tip
If the points aren't displaying where you expect them to display, visit Help . You can also customize pop-up balloons in Google Fusion Tables using :guilabel:`Change info window` button under the :menuselection:`Feature map` option.
:dfn:`Google Earth` is a virtual globe that accesses satellite and aerial imagery, and other geographic data over the internet to represent the Earth as a three-dimensional globe
Follow these steps to view your data using Google Earth:
- Login to your ODK Aggregate server.
- In the :guilabel:`Submissions` tab, under :guilabel:`Filter Submissions`, select the form you want to use and click on :guilabel:`Export`
- Choose the type as :file:`KML file` and click on :guilabel:`Export`.
- You don't need to change the default options, but you can select the :menuselection:`title` according to your choice. Click on :guilabel:`Export`
- You will be redirected to :guilabel:`Export Submissions` page where you can download your kml file.
- After downloading go to Google Earth website or you can download it from here. Wait for a while as Google Earth takes time to load.
- Click on
and to enable KML import click on :guilabel:`Settings`.
- In the Settings window, enable KML file import and click on :guilabel:`SAVE`.
- Click on :guilabel:`IMPORT KML FILE` and import the downloaded kml file.
- Now you will be able to see your data in an organized manner on Google Earth.
Tip
- On Google Earth, you can choose your map style, add additional points, lines and polygons to add more information for the enhancement of map. You can also try out this tutorial on how to annotate Google Earth.