android/android-emu/android/emulation/control/location_agent.h

/* Copyright (C) 2015 The Android Open Source Project
 **
 ** This software is licensed under the terms of the GNU General Public
 ** License version 2, as published by the Free Software Foundation, and
 ** may be copied, distributed, and modified under those terms.
 **
 ** This program is distributed in the hope that it will be useful,
 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 ** GNU General Public License for more details.
 */

#pragma once

#include "android/utils/compiler.h"

#include <stdbool.h>
#include <sys/time.h>

ANDROID_BEGIN_HEADER

typedef struct QAndroidLocationAgent {
    // Query whether the device implementation supports GPS.
    bool (*gpsIsSupported)(void);

    // Send a GPS location to the AVD using an NMEA sentence
    //   |latitude| and |longitude| are in degrees
    //   |metersElevation| is meters above sea level
    //   |nSatellites| is the number of satellites used
    //   |time| is UTC, in the format provided by gettimeofday()
    void (*gpsSendLoc)(double latitude, double longitude,
                       double metersElevation, int nSatellites,
                       const struct timeval *time);

    // Get the current device location
    //
    // Returns 1 if the device location was successfully
    //   received from the device, 0 if unsuccessful
    // If the return is 1, the output values are set:
    //   |outLatitude| and |outLongitude| are in degrees
    //   |outMetersElevation| is meters above sea level
    //   |outNSatellites| is the number of satellites used
    // Null 'out' pointers are safely ignored.
    int (*gpsGetLoc)(double* outLatitude, double* outLongitude,
                     double* outMetersElevation, int* outNSatellites);

    // Send an NMEA fix sentence to the device.
    void (*gpsSendNmea)(const char* sentence);
} QAndroidLocationAgent;

ANDROID_END_HEADER