[edit] Hello Marble!

The Marble API allows a very easy integration of a map widget into your application. Let's prove that with a tiny "Hello world"-like example:

#include <QtGui/QApplication>
#include <marble/MarbleWidget.h>
 
using namespace Marble;
 
int main(int argc, char** argv)
{
    QApplication app(argc,argv);
 
    // Create a Marble QWidget without a parent
    MarbleWidget *mapWidget = new MarbleWidget();
 
    // Load the OpenStreetMap map
    mapWidget->setMapThemeId("earth/openstreetmap/openstreetmap.dgml");
 
    // Set a server for downloading map data, if needed
    mapWidget->setDownloadUrl("http://download.kde.org/apps/marble/");
    mapWidget->show();
 
    return app.exec();
}

Save the code above as my_marble.cpp and compile it:

g++ -I /usr/include/qt4/ -o my_marble my_marble.cpp -lmarblewidget -lQtGui

If things go fine, execute ./my_marble and you end up with a fully usable OpenStreetMap application:

Here's a little checklist to tackle some problems that might arise when compiling the code above:

• You need Qt and Marble development packages (or comparable SVN installations)
• If you're running Marble from SVN, remove the setDownloadUrl() function call. It's obsolete and not needed anymore.
• If Qt headers are not installed in /usr/include/qt4 on your system, change the path in the g++ call above accordingly.
• Likewise, add -I /path/to/marble/headers if they're not to be found in /usr/include