Marble/OfflineSearch: Difference between revisions

From KDE Wiki Sandbox
No edit summary
No edit summary
Line 12: Line 12:
Marble will do a case-insensitive search for 'Baker Street' located in 'London'.
Marble will do a case-insensitive search for 'Baker Street' located in 'London'.


If you're not sure whether the street you're looking for was 'Baker Street' or 'Bakery Street', you can search for the common part of both and Marble will find both (if they exist): {{Input|1=Baker, London}}
==== Searching for House Numbers ====
 
=== POI Search ===
Searching for points of interest works very similar to the address search described above. Enter the name of the POI first and the city it's located in second. Separate both with a comma. {{Input|1=Burger King, London}}
 
=== Searching for House Numbers ===
A growing number of houses is listed in OpenStreetMap with their number. House numbers are listed in normal address searches as well, but you can limit the results to specific house numbers as well. To achieve this, use the form {{Input|1=221b, Baker Street, London}}
A growing number of houses is listed in OpenStreetMap with their number. House numbers are listed in normal address searches as well, but you can limit the results to specific house numbers as well. To achieve this, use the form {{Input|1=221b, Baker Street, London}}


Line 24: Line 19:
{{note|The shorter form ''StreetName HouseNumber, City'' does only work for common house numbers that start with one or more digits and optionally end with a letter.}}
{{note|The shorter form ''StreetName HouseNumber, City'' does only work for common house numbers that start with one or more digits and optionally end with a letter.}}


=== Searching by POI Category ===
If you're not sure whether the street you're looking for was 'Baker Street' or 'Bakery Street', you can search for the common part of both and Marble will find both (if they exist): {{Input|1=Baker, London}}
 
=== POI Search ===
Searching for points of interest works very similar to the address search described above. Enter the name of the POI first and the city it's located in second. Separate both with a comma. {{Input|1=Burger King, London}}
 
==== Searching by POI Category ====
Marble knows several different categories of points of interest. You can search for all POIs of a certain category for a given city. The query {{Input|1=Restaurant, London}} for example returns all restaurants in London. POI searches are especially useful in combination with a location aware search (see below).
Marble knows several different categories of points of interest. You can search for all POIs of a certain category for a given city. The query {{Input|1=Restaurant, London}} for example returns all restaurants in London. POI searches are especially useful in combination with a location aware search (see below).


Known POI categories are ''airport, attraction, bank, bar, beverages, biergarten, bus station, bus stop, cafe, camping, car share, castle, cinema, college, doctor, fast food, fuel, hifi, hospital, hostel, hotel, library, monument, motel, museum, parking, pharmacy, pub, restaurant, ruin, school, supermarket, theatre, theme park, train station, university, view point, youth hostel'' and ''zoo''.
Known POI categories are ''airport, attraction, bank, bar, beverages, biergarten, bus station, bus stop, cafe, camping, car share, castle, cinema, college, doctor, fast food, fuel, hifi, hospital, hostel, hotel, library, monument, motel, museum, parking, pharmacy, pub, restaurant, ruin, school, supermarket, theatre, theme park, train station, university, view point, youth hostel'' and ''zoo''.


{{note|The POI category names are translated. If you use a non-english version of Marble, you can also search for the categories in your native language. ''School'' for example is ''Schule'' in German.}}
{{note|The POI category names are translated. If you use a non-english version of Marble, you can also search for the categories in your native language. ''School'' for example is ''Schule'' in German. Therefore both queries ''School, London'' and ''Schule, London'' return the same results in the German version of Marble.}}


=== Location Aware Search ===
=== Searching the Neighborhood ===
TODO
When travelling you're probably interested in things around you: The next gas station when running out of fuel, a restaurant to pick up some food, a parking spot near your destination or a nice pub next to your hotel. If GPS is activated and Marble knows your position, these kind of searches become even simpler: Just omit the city name in queries. {{Input|1=Restaurant}} for example will find restaurants in the neighborhood. For your convenience Marble includes the distance and direction to each result in the output and sorts the result list by distance such that closer places are listed on top.


== Installation ==
== Installation ==
TODO
{{warning|The monav offline maps have not been extended like described in this section at the time of writing (2011/05/03).}}
 
Marble includes only a limited number of placemarks (cities) for offline search in the default installation for space reasons. These default placemarks do not support the search features described on this page. You can install additional placemark databases however. For your convenience we have packaged them together with the monav offline maps. These maps can be downloaded on a country level. Once installed, the placemark database is automatically included in future search queries.
 
{{note|If you're using a monav offline map from Marble 1.1 or older, please upgrade this map. You can upgrade monav offline maps from within Marble.}}


== Upgrading ==
== Upgrading ==
TODO
TODO

Revision as of 21:06, 3 May 2011

Under Construction
This is a new page, currently under construction!


Warning
This page describes features only available in Marble 1.2 and later. This version has not been released in a stable version at the time of writing (2011/04/30).


Introduction

This page introduces Marble's offline search: Searching for addresses and points of interest (POIs), installation of additional search databases and upgrading from previous versions.

Searching

Address Search

The most common way to search for addresses is to enter the street name, a comma, and the city the street is located in like this:

Baker Street, London

Marble will do a case-insensitive search for 'Baker Street' located in 'London'.

Searching for House Numbers

A growing number of houses is listed in OpenStreetMap with their number. House numbers are listed in normal address searches as well, but you can limit the results to specific house numbers as well. To achieve this, use the form

221b, Baker Street, London

Because this way of searching is not too intuitive for many, Marble supports an alternative form. Entering

Baker Street 221b, London

is another way to query this house number.

Note
The shorter form StreetName HouseNumber, City does only work for common house numbers that start with one or more digits and optionally end with a letter.


If you're not sure whether the street you're looking for was 'Baker Street' or 'Bakery Street', you can search for the common part of both and Marble will find both (if they exist):

Baker, London

POI Search

Searching for points of interest works very similar to the address search described above. Enter the name of the POI first and the city it's located in second. Separate both with a comma.

Burger King, London

Searching by POI Category

Marble knows several different categories of points of interest. You can search for all POIs of a certain category for a given city. The query

Restaurant, London

for example returns all restaurants in London. POI searches are especially useful in combination with a location aware search (see below).

Known POI categories are airport, attraction, bank, bar, beverages, biergarten, bus station, bus stop, cafe, camping, car share, castle, cinema, college, doctor, fast food, fuel, hifi, hospital, hostel, hotel, library, monument, motel, museum, parking, pharmacy, pub, restaurant, ruin, school, supermarket, theatre, theme park, train station, university, view point, youth hostel and zoo.

Note
The POI category names are translated. If you use a non-english version of Marble, you can also search for the categories in your native language. School for example is Schule in German. Therefore both queries School, London and Schule, London return the same results in the German version of Marble.


Searching the Neighborhood

When travelling you're probably interested in things around you: The next gas station when running out of fuel, a restaurant to pick up some food, a parking spot near your destination or a nice pub next to your hotel. If GPS is activated and Marble knows your position, these kind of searches become even simpler: Just omit the city name in queries.

Restaurant

for example will find restaurants in the neighborhood. For your convenience Marble includes the distance and direction to each result in the output and sorts the result list by distance such that closer places are listed on top.

Installation

Warning
The monav offline maps have not been extended like described in this section at the time of writing (2011/05/03).


Marble includes only a limited number of placemarks (cities) for offline search in the default installation for space reasons. These default placemarks do not support the search features described on this page. You can install additional placemark databases however. For your convenience we have packaged them together with the monav offline maps. These maps can be downloaded on a country level. Once installed, the placemark database is automatically included in future search queries.

Note
If you're using a monav offline map from Marble 1.1 or older, please upgrade this map. You can upgrade monav offline maps from within Marble.


Upgrading

TODO