googleearthkml.h

/******************************************************************************
* Copyright (c) ATTX LLC 2024. All Rights Reserved.
*
* This software and associated documentation (the "Software") are the 
* proprietary and confidential information of ATTX, LLC. The Software is 
* furnished under a license agreement between ATTX and the user organization 
* and may be used or copied only in accordance with the terms of the agreement.
* Refer to 'license/attx_license.adoc' for standard license terms.
*
* EXPORT CONTROL NOTICE: THIS SOFTWARE MAY INCLUDE CONTENT CONTROLLED UNDER THE
* INTERNATIONAL TRAFFIC IN ARMS REGULATIONS (ITAR) OR THE EXPORT ADMINISTRATION 
* REGULATIONS (EAR99). No part of the Software may be used, reproduced, or 
* transmitted in any form or by any means, for any purpose, without the express 
* written permission of ATTX, LLC.
******************************************************************************/
#ifndef UTILS_GOOGLEEARTHKML_H
#define UTILS_GOOGLEEARTHKML_H
 
#include <string>
#include <vector>
 
namespace modelspace {
 
    /// @brief Function to write a trajectory into a KML file  
    /// @param lat A vector of doubles corresponding to latitude
    /// @param lon A vector of doubles corresponding to longitude
    /// @param alt A vector of doubles corresponding to altitude
    /// @param project_to_ground A bolean indicating whether the trajectory should be projected to the ground
    /// @return A string to be written with all trajectory data
    std::string writeTrajectory(const std::vector<double> &lat,
                                const std::vector<double> &lon,
                                const std::vector<double> &alt,
                                bool project_to_ground=true,
                                const std::string &color="7f00ffff");
 
    /// @brief Function to write a full KML file from trajectory data
    /// @param file The file to write kml data to
    /// @param lat A vector of doubles corresponding to latitude
    /// @param lon A vector of doubles corresponding to longitude
    /// @param alt A vector of doubles corresponding to altitude
    /// @param colors A vector of 
    /// @param project_to_ground A bolean indicating whether the trajectory should be projected to the ground
    void writeKmlFile(const std::string &file,
                    const std::vector<std::vector<double>> &lat,
                    const std::vector<std::vector<double>> &lon,
                    const std::vector<std::vector<double>> &alt,
                    const std::vector<std::string> &colors,
                    bool project_to_ground=true);
 
}
 
#endif