Projects/Marble/Runners/Search - Revision history

Mayankmadan at 16:55, 13 January 2013

2013-01-13T16:55:48Z

AnneW at 17:42, 19 July 2012

2012-07-19T17:42:14Z

Earthwings: /* Searching for cities, addresses, points of interest */

2012-01-07T18:09:34Z

‎Searching for cities, addresses, points of interest

Tgridel: /* Searching for cities, addresses, points of interest */

2012-01-07T12:11:03Z

‎Searching for cities, addresses, points of interest

Earthwings: fix tutorial header

2012-01-07T11:28:05Z

fix tutorial header

Earthwings: Created page with "{{Template:I18n/Language Navigation Bar|Editing Projects/Marble/MarbleCPlusPlus}} {{TutorialBrowser| series=Marble C++ Tutorial| name=Search pre=[[Projects/Marble/Routing/Basi..."

2012-01-07T11:19:37Z

Created page with "{{Template:I18n/Language Navigation Bar|Editing Projects/Marble/MarbleCPlusPlus}} {{TutorialBrowser| series=Marble C++ Tutorial| name=Search pre=[[Projects/Marble/Routing/Basi..."

New page

{{Template:I18n/Language Navigation Bar|Editing Projects/Marble/MarbleCPlusPlus}}
{{TutorialBrowser|

series=Marble C++ Tutorial|

name=Search

pre=[[Projects/Marble/Routing/BasicRouting|Tutorial 6 - Basic Routing]]|

next=[[Projects/Marble/Runners/ReverseGeocoding|Tutorial 8 - Reverse Geocoding]]|
}}

== Searching for cities, addresses, points of interest ==
Marble uses so-called runners to calculate routes, do reverse geocoding, parse files and search for placemarks (cities, addresses, points of interest, ...). This tutorial shows how to use the <tt>MarbleRunnerManager</tt> class to search for an arbitrary string (<i>Karlsruhe</i> in the example below, see [http://userbase.kde.org/Marble/Search Userbase] for more information on search terms).

<source lang="cpp-qt">
#include <QtGui/QApplication>
#include <QtCore/QDebug>

#include <marble/MarbleWidget.h>
#include <marble/MarbleModel.h>
#include <marble/MarbleRunnerManager.h>
#include <marble/GeoDataPlacemark.h>

using namespace Marble;

int main(int argc, char** argv)
{
QApplication app(argc,argv);
MarbleWidget *mapWidget = new MarbleWidget;
MarbleModel *model = mapWidget->model();

MarbleRunnerManager* manager = new MarbleRunnerManager( model->pluginManager() );
manager->setModel( model );

QVector<GeoDataPlacemark*> searchResult = manager->searchPlacemarks( "Karlsruhe" );
foreach( GeoDataPlacemark* placemark, searchResult ) {
qDebug() << "Found " << placemark->name() << "at" << placemark->coordinate().toString();
}
}
</source>

Copy and paste the code above into a text editor. Then save it as <tt>my_marble.cpp</tt> and compile it by entering the following command on the command line:

<source lang="bash">
g++ -I /usr/include/qt4/ -o my_marble my_marble.cpp -lmarblewidget -lQtGui -lQtCore
</source>

If things go fine, execute <tt>./my_marble</tt> and the output looks similar to this:
<source lang="text">
Found "Karlsruhe, Germany" at " 8° 33' 48.7"E, 49° 05' 38.4"N"
Found "Karlsruhe, McLean" at "100° 36' 58.4"W, 48° 05' 27.7"N"
Found "Karlsruhe, Karlsruhe, Stadt" at " 8° 24' 16.0"E, 49° 00' 50.6"N"
Found "Karlsruhe, Remscheid" at " 7° 17' 35.3"E, 51° 09' 09.4"N"
Found "Karlsruhe, Austria" at " 15° 19' 53.6"E, 47° 21' 33.4"N"
Found "Karlsruhe, McLean" at "100° 37' 13.5"W, 48° 05' 24.0"N"
Found "Karlsruhe, Sohland a.d. Spree" at " 14° 27' 36.5"E, 51° 02' 28.5"N"
Found "Parkstraße, Bad Elster" at " 12° 14' 08.0"E, 50° 16' 57.9"N"
Found "Karlsruhe (Bruchsal)" at " 8° 33' 48.7"E, 49° 05' 38.4"N"
Found "Karlsruhe (Innenstadt-West)" at " 8° 24' 16.0"E, 49° 00' 50.6"N"
</source>

{{tip|
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 git installations), version 1.3 (Marble library 0.13), shipped e.g. with KDE 4.8
* 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
}}
{{note|
If you provide maps in your application please check the '''Terms of Use''' of the map material. The map material that is shipped with Marble is licensed ''in the spirit of Free Software''. This usually means at least that the authors should be credited and that the license is mentioned.
E.g. for ''OpenStreetMap'' the license is [http://creativecommons.org/license/by-sa/2.0 CC-BY-SA]. Other map data shipped with Marble is either public domain or licensed in the spirit of the BSD license.
}}

@@ Line 6: / Line 6: @@
 name=Search|
-pre=[[Projects/Marble/Routing/BasicRouting|Tutorial 6 - Basic Routing]]|
+pre=[[Projects/Marble/Routing/BasicRouting|Tutorial 9 - Basic Routing]]|
-next=[[Projects/Marble/Runners/ReverseGeocoding|Tutorial 8 - Reverse Geocoding]]|
+next=[[Projects/Marble/Runners/ReverseGeocoding|Tutorial 11 - Reverse Geocoding]]|
 }}

← Older revision		Revision as of 17:42, 19 July 2012
Line 1:		Line 1:
−	~~{{Template:I18n/Language Navigation Bar\|Editing Projects/Marble/MarbleCPlusPlus}}~~	+
	{{TutorialBrowser\|		{{TutorialBrowser\|

@@ Line 28: / Line 28: @@
+{
      QApplication app(argc,argv);
-     MarbleWidget *mapWidget = new MarbleWidget;
+     MarbleModel *model = new MarbleModel;
-    MarbleModel *model = mapWidget->model();
      MarbleRunnerManager* manager = new MarbleRunnerManager( model->pluginManager() );

@@ Line 64: / Line 64: @@
 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 git installations), version 1.3 (Marble library 0.13), shipped e.g. with KDE 4.8
+* You need Qt and '''Marble development packages''' (or comparable git installations), version 1.3 (Marble library 0.13), shipped post KDE 4.8
 * 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