Geolocalização e Mapas em C++: bibliotecas libcurl, nlohmann/json, Leaflet

Geolocalização e Mapas em C++: visão geral das ferramentas e exemplos de implementação

No mundo moderno, dados de geolocalização e mapas interativos tornaram-se parte essencial de muitas aplicações — desde serviços de navegação até jogos e sistemas de monitoramento. O desenvolvimento em C++ não é exceção: embora a linguagem em si não forneça recursos nativos para trabalhar com dados geoespaciais, existe um poderoso ecossistema de bibliotecas que permite integrar geolocalização e mapas em seus projetos. Neste artigo, exploraremos as principais ferramentas: libcurl para requisições HTTP, nlohmann/json para análise de respostas JSON de APIs e Leaflet (através da geração de HTML/JavaScript) para exibição de mapas.

1. Principais bibliotecas para trabalhar com geolocalização

libcurl é uma biblioteca poderosa e testada pelo tempo para transferência de dados por vários protocolos, incluindo HTTP/HTTPS. Ela é ideal para enviar requisições a APIs de geolocalização (por exemplo, OpenStreetMap Nominatim ou Google Maps Geocoding).

nlohmann/json é uma biblioteca moderna, leve e intuitiva para trabalhar com JSON. Ela permite serializar e desserializar facilmente os dados obtidos de serviços de geolocalização.

Leaflet é a principal biblioteca JavaScript para criar mapas interativos. Em um projeto C++, você pode gerar um arquivo HTML que utiliza Leaflet para exibir os dados obtidos pela sua aplicação C++.

2. Instalação dos componentes necessários

Para começar, você precisará instalar as bibliotecas. Na maioria das distribuições Linux, isso é feito através do gerenciador de pacotes:

# Instalação do libcurl e nlohmann-jsonsudo apt-get install libcurl4-openssl-dev nlohmann-json3-dev  # Debian/Ubuntusudo dnf install libcurl-devel json-devel                    # Fedora

Para trabalhar com Leaflet, basta baixar a versão mais recente e incluir os arquivos CSS/JS no HTML gerado.

3. Exemplo: obtendo coordenadas a partir de um endereço (Geocoding)

Vamos implementar uma função que recebe o nome de uma cidade e retorna sua latitude e longitude, usando a API Nominatim (OpenStreetMap).

#include <iostream>#include <string>#include <curl/curl.h>#include <nlohmann/json.hpp>

using json = nlohmann::json;

// Função de callback para escrever a resposta do CURL em uma stringsize_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {    size_t totalSize = size * nmemb;    output->append(static_cast<char*>(contents), totalSize);    return totalSize;}

std::pair<double, double> getCoordinates(const std::string& address) {    CURL* curl = curl_easy_init();    if (!curl) throw std::runtime_error("Erro ao inicializar CURL");

    std::string response;    std::string url = "https://nominatim.openstreetmap.org/search?q="                       + curl_easy_escape(curl, address.c_str(), address.length())                       + "&format=json&limit=1";

    curl_easy_setopt(curl, CURLOPT_URL, url.c_str());    curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);    curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);    curl_easy_setopt(curl, CURLOPT_USERAGENT, "CppGeoApp/1.0"); // Obrigatório para Nominatim

    CURLcode res = curl_easy_perform(curl);    curl_easy_cleanup(curl);

    if (res != CURLE_OK) throw std::runtime_error(curl_easy_strerror(res));

    json jsonData = json::parse(response);    if (jsonData.empty()) throw std::runtime_error("Endereço não encontrado");

    double lat = jsonData[0]["lat"].get<double>();    double lon = jsonData[0]["lon"].get<double>();    return {lat, lon};}

int main() {    try {        auto [lat, lon] = getCoordinates("Moscou, Kremlin");        std::cout << "