Search Management Map Asset API

A C library for accessing the asset side of the API for Search Management Map

Getting started

Prerequisites

• libcurl
• libtidy
• Jansson

Fetching and building

git clone https://github.com/canterbury-air-patrol/smm-asset-api.git
cd smm-asset-api
./autogen.sh
./configure -prefix=/usr
make
make install

Using

Link your program against -lsmmasset or use pkg-config with the installed smm-asset.pc.

Basic API usage example

#include <smm-asset.h>

int main(int argc, char *argv[])
{
	smm_asset *assets;
	size_t assets_count;
	smm_asset asset = NULL;

	smm_connection conn = smm_asset_connect ("http://localhost/", "asset", "assetpassword");
	if (smm_asset_get_assets (conn, &assets, assets_count))
	{
		for (size_t i = 0; i < assets_count; i++)
		{
			if (strcmp (smm_asset_get_name (assets[i]), "my-asset") == 0)
			{
				asset = assets[i];
			}
		}
	}
	if (asset != NULL)
	{
		/* Report this assets position as 43 deg South, 172 deg East, 35 meters high, heading west, 3d fix */ 
		smm_asset_report_position (asset, -43, 172, 35, 270, 3);

		/* You can also get a search to conduct by */
		smm_search search;
		do {
			search = smm_asset_get_search (asset, -43, 172);
		} while (!smm_search_accept (search));
		/* All the waypoints for the search are accessible with */
		smm_waypoints waypoints;
		size_t waypoints_count;
		smm_search_waypoints_get (search, &waypoints, &waypoints_count);
		/* Iterate them the same as assets, then free with */
		smm_waypoints_free (waypoints, waypoints_count);
		/* Once the search is completed then */
		smm_search_completed (search);
		smm_search_destroy (search);
	}

	smm_asset_free_assets (assets, assets_count);
	smm_connection_close (conn);
}

Authors

See the list of contributors.

License

This project is licensed under GNU LGPLv2.1 see the LICENSE.md file for details.