"How to" for the Oneline Search SDK

Introduction

The Scout SDK OneLine experience is an improvement over the existing search capabilities, allowing users to easily enter a variety of local search queries in a single text box. It has the capability to parse what the users are looking for (business name, address, airport) and to deliver relevant results centered around a set location.

By default OneLine queries OpenStreetMap based results.

Additional search sources may be queries by adding additional 3'rd party search providers (Apple search, Foursquare, Tripadvisor, etc.) - the integration with the 3'rd party data sources will be done client side.

Handling categories and reverse geocoding

Currently the OneLine API does not identify category searches (searching for "restaurant" or "hotel") or reverse geocoding requests (searching for a coordinate).

It is up to the client to determine that we are dealing with a category search or a reverse geocoding request and redirect the call to the appropriate API (category search /nearby search or reverse geocoding API).

Connected search

The connected (or cloud version) of the OneLine search will provide the ability to query the entire world at all times: you will be able to search for addresses and POIs in Paris, France even though you are currently in New York, NY, US.

Embedded search (offline)

The onboard (embedded or offline) version of the OneLine search provides an experience similar to "connected" but with reduced scope - only the available offline packages will be queried. (one has to have the offline package available locally on the device).

3'rd party search providers may, or may not be available in the embedded mode - availability varying based on provider and the integration details.

For the rest of the document, unless specifically mentioned, we will be referring to the OpenStreetMap powered search capabilities.

One line search

When search is performed in a text box, the query will be sent to all available search providers, the results being merged back to one results list when they become available.

The OneLine algorithm does limited query classification (i.e. breaking down "11 Main Street, Sunnyvale, CA" into "11 = door number", "Main Street = Address", "Sunnyvale = City", "CA = State") as it mostly relies on direct text match + scoring algorithm.

This means that the original query "11 Main Street, Sunnyvale, CA" will be treated as text and it will be matched against a number of combinations, both addresses and POIs, and once all the candidate results have returned another scoring session happens, the candidate most similar to the original query (text wise) surfacing on top.

Ranking details

View search acceptance document
Search acceptance criteria
Legend 1 1st result in the list
2 2nd result in the list
3 3rd result in the list
4 4th result in the list
5 5th result in the list
Big City >300.000 inhabitans
Small City <300.000 inhabitans
Close <22km
Far >22km
Airport It is important to test based on airport codes: CLJ - Cluj, SFO - San Francisco, MUC - Munich etc
Full full string match (e.g. Cluj Napoca)
Partial partial string match (e.g. Cluj Nap)
Result type Position in list
big city close full 1
airport close full 1
airport far full 1
street close full 2
poi close full 2
big city far full 2
street close partial 2
poi close partial 2
big city close partial 2
street far full 3
big city far partial 3
airport close part 3
POI far full 4
city small far full 4
airport far partial 5
city small far partial 5
street far partial 5
POI far partial 5

Places (POIs) vs address search

The OneLine search will query both the places (POI) database and the address database trying to match the input string - in the aggregated result list both types of responses, addresses and POIs, will be present.

Search patterns

Since the OneLine tool has very limited logical understanding of the input text (query classification) as it mostly relies on text search, it is important to understand what are the supported input strings and what are the limitations.

I.e. Searching for "McDonalds, San Francisco" will return results while searching for "McDonalds, 235 Front St, San Francisco" will not return any results as the POIs and addresses are not connected in the backend (a POI does not have an address associated to it, only a location).

Supported search patterns

Search type Search Pattern Example(s) Notes
Street Street Name De Guide Drive
Door Number, Street Name 950 De Guide Drive
Street Name, City Island Blvd, Aventura
Street Name, City, State TI Blvd, Dallas Texas (*) only complete state names are supported: i.e. Texas instead of TX
Street Name, Postcode Main Street 19904
City City name San Francisco
City name, State San Francisco, California
Zip code 48126
Zip code, City 89101 Las Vegas
POI (business) name POI name Olivo Caffe
POI name City Bank of America San Jose
POI name Zip code Target 94086
Airport code or Airport name SFO, Chicago O'Hare

Not supported search patterns

Search type Search Pattern Example(s) Notes
Street Address Various prepositions: near, in, around 201 South Street near Boston
POI (business) category Category City Hotels, Detroit This is supported via the category search API
POI (business) name Brand Name Shell This will search for POIs specifically name or containing "Shell" - it will not look for the brand "Shell"
POI Name Street PFChang Mathilda Avenue This is not supported as currently POIs and addresses are not linked in the backend
Other Intersection search: Street Name & Street Name B San Antonio and California St
Landmarks by name or abbreviation Statue of Liberty

Fuzzy search

Below table depicts fuzzy search variations which the SDK offers support:

Feature Example(s) Notes
Street type abbreviation Road <-> Rd, Lane <-> Ln This depends whether the relation is defined in the synonyms & abbreviation dictionary
Street direction abbreviation W <-> West This depends whether this relation is defined in the synonyms & abbreviation dictionary
Language character mapping ß <-> ss, Ö <-> o Non latin characters are transliterated. In the backend both the transliterated name (only ascii character) and the display name are stored - in the first stage the matching is done against the transliterated name and once the candidate results have been identified another scoring session takes place, the exact input (containing diacritics) being matched against the display name making it so that the candidate results that score good against both the transliterated name and the display name to receive higher positions.
Other synonyms See the complete synonyms & abbreviation list for your specific country.
Spelling correction coffe <-> coffee Currently OneLine has one letter fault tolerance per word ( i.e. Cuza1 Vooda will be matched to Cuza Voda but might be also matched to Cuza Voida).
When scoring, the results that better match the exact input query (even if there is a type-o there) will be ranked higher than those that match against the grammatically or logical correct results.

Discovery support

POI discovery is handled by the nearby search and the category search APIs.

Suggestions support

As the user starts typing the system tries to generate relevant suggestions based on matches made based on the partial query. The same matching & scoring rules apply for both complete and incomplete queries.

Synonyms & abbreviations dictionaries

United States

Extended word Synonym/Abbreviation
Access Accs
Air Force Base AFB
Air National Guard Base ANGB
Airport Aprt
Alley Al
Alleyway Alwy
Amble Ambl
Apartments Apts
Arcade Arc
Arterial Artl
Artery Arty
Avenue Ave
Back Bk
Banan Ba
Beach Bch
Bend Bnd
Block Blk
Boardwalk Bwlk
Boulevard Blvd
Boundary Bdy
Bowl Bl
Brace Br
Brae Br
Break Brk
Broadway Bway
Brook Brk
Brow Brw
Business Bus
Bypass Bypa
Byway Bywy
Caravan Cvn
Central Ctrl
Centre Ctr
Centreway Cnwy
Chase Ch
Church Ch
Circle Cir
City Cty
Close Cl
Community Comm
Copse Cps
Corso Cso
Cottages Cotts
County Co
County Road CR
County Route CR
Court Ct
Courtyard Ctyd
Croft Cft
Cross Cs
Crossing Xing
Crossroad Crd
Crossway Cowy
Curve Cve
Cutting Cutt
Dale Dle
Deviation Devn
Distributor Dstr
Down Dn
Downs Dn
Drive Dr
Driveway Drwy
East E
Edge Edg
Elbow Elb
Entrance Ent
Esplanade Esp
Estate Est
Expressway Expwy
Extension Ex
Father Fr
Ferry Fy
Field Fd
Fire Track Ftrk
Firetrail Fit
Flat Fl
Follow Folw
Footway Ftwy
Foreshore Fshr
Formation Form
Fort Ft
Freeway Fwy
Front Frnt
Frontage Fr
Garden Gdn
Gardens Gdn
Gateway Gwy
George Geo
Glade Gl
Glen Gln
Grange Gra
Ground Grnd
Grove Gr
Grovet Gr
Gully Gly
Harbor Hbr
Harbour Hbr
Haven Hvn
Head Hd
Heads Hd
Heights Hgts
High School HS
Highway Hwy
Hill Hl
Hills Hls
Hospital Hosp
House Ho
Industrial Ind
Interchange Intg
International Intl
Island Is
Junction Jnc
Junior Jr
Lagoon Lgn
Lakes L
Landing Ldg
Lane Ln
Laneway Lnwy
Line Ln
Link Lk
Lodge Ldg
Lookout Lkt
Loop Lp
Mall Ml
Manor Mnr
Mansions Mans
Market Mkt
Mead Md
Meadow Mdw
Meadows Mdws
Medical Med
Memorial Mem
Mews Mw
Middle Mid
Middle School MS
Mile Mi
Military Mil
Motorway Mwy
Mount Mt
Mountain Mtn
Mountains Mtn
Municipal Mun
Museum Mus
National Park NP
National Recreation Area NRA
National Wildlife Refuge Area NWRA
Nook Nk
North N
Northeast NE
Northwest NW
Outlook Out
Parade Pde
Paradise Pdse
Park Pk
Parklands Pkld
Parkway Pkwy
Pass Ps
Passage Psge
Pathway Pway
Piazza Piaz
Pike Pk
Place Pl
Plain Pl
Plains Pl
Plateau Plat
Plaza Pl
Pocket Pkt
Point Pt
Port Pt
Post Office PO
Precinct Pct
Quay Qy
Quays Qy
Ramble Rmbl
Range Rge
Reach Rch
Reservation Res
Reserve Res
Reservoir Res
Rest Rst
Retreat Rt
Return Rtn
Ridge Rdg
Ridgeway Rgwy
Rise Ri
Riverway Rvwy
Riviera Rvra
Road Rd
Roads Rds
Roadside Rdsd
Roadway Rdwy
Robert Robt
Saint St
Saints SS
Senior Sr
Serviceway Swy
Shunt Shun
Siding Sdng
Sister Sr
Slope Slpe
Sound Snd
South S
Southeast SE
Southwest SW
Square Sq
Stairway Strwy
State Highway SH
State Route SR
Station Stn
Strand Sd
Street St
Strip Strp
Subway Sbwy
Tarn Tn
Terminal Term
Terrace Terr
Thoroughfare Thfr
Tollway Twy
Towers Twrs
Township Twp
Trace Trce
Track Tr
Trail Trl
Trailer Trlr
Triangle Tri
Trunkway Tkwy
Tunnel Tun
Turn Trn
Turnpike Tpk
Underpass Ups
University Uni
Upper Upr
Vale Va
Valley Vy
Viaduct Via
View Vw
Village Vill
Villas Vlls
Vista Vst
Walk Wk
Walkway Wky
Waters Wtr
Way Wy
West W
Wharf Whrf
William Wm
Wynd Wyn
Yard Yd

Great Britain

Extended word Synonym/Abbreviation
Access Accs
Air Force Base AFB
Air National Guard Base ANGB
Airport Aprt
Alley Al
Alleyway Alwy
Amble Ambl
Apartments Apts
Arcade Arc
Arterial Artl
Artery Arty
Avenue Ave
Back Bk
Banan Ba
Beach Bch
Bend Bnd
Block Blk
Boardwalk Bwlk
Boulevard Blvd
Boundary Bdy
Bowl Bl
Brace Br
Brae Br
Break Brk
Broadway Bway
Brook Brk
Brow Brw
Business Bus
Bypass Bypa
Byway Bywy
Caravan Cvn
Central Ctrl
Centre Ctr
Centreway Cnwy
Chase Ch
Church Ch
Circle Cir
City Cty
Close Cl
Community Comm
Copse Cps
Corso Cso
Cottages Cotts
County Co
County Road CR
County Route CR
Court Ct
Courtyard Ctyd
Croft Cft
Cross Cs
Crossing Xing
Crossroad Crd
Crossway Cowy
Curve Cve
Cutting Cutt
Dale Dle
Deviation Devn
Distributor Dstr
Down Dn
Downs Dn
Drive Dr
Driveway Drwy
East E
Edge Edg
Elbow Elb
Entrance Ent
Esplanade Esp
Estate Est
Expressway Expwy
Extension Ex
Father Fr
Ferry Fy
Field Fd
Fire Track Ftrk
Firetrail Fit
Flat Fl
Follow Folw
Footway Ftwy
Foreshore Fshr
Formation Form
Fort Ft
Freeway Fwy
Front Frnt
Frontage Fr
Garden Gdn
Gardens Gdn
Gateway Gwy
George Geo
Glade Gl
Glen Gln
Grange Gra
Ground Grnd
Grove Gr
Grovet Gr
Gully Gly
Harbor Hbr
Harbour Hbr
Haven Hvn
Head Hd
Heads Hd
Heights Hgts
High School HS
Highway Hwy
Hill Hl
Hills Hls
Hospital Hosp
House Ho
Industrial Ind
Interchange Intg
International Intl
Island Is
Junction Jnc
Junior Jr
Lagoon Lgn
Lakes L
Landing Ldg
Lane Ln
Laneway Lnwy
Line Ln
Link Lk
Lodge Ldg
Lookout Lkt
Loop Lp
Mall Ml
Manor Mnr
Mansions Mans
Market Mkt
Mead Md
Meadow Mdw
Meadows Mdws
Medical Med
Memorial Mem
Mews Mw
Middle Mid
Middle School MS
Mile Mi
Military Mil
Motorway Mwy
Mount Mt
Mountain Mtn
Mountains Mtn
Municipal Mun
Museum Mus
National Park NP
National Recreation Area NRA
National Wildlife Refuge Area NWRA
Nook Nk
North N
Northeast NE
Northwest NW
Outlook Out
Parade Pde
Paradise Pdse
Park Pk
Parklands Pkld
Parkway Pkwy
Pass Ps
Passage Psge
Pathway Pway
Piazza Piaz
Pike Pk
Place Pl
Plain Pl
Plains Pl
Plateau Plat
Plaza Pl
Pocket Pkt
Point Pt
Port Pt
Post Office PO
Precinct Pct
Quay Qy
Quays Qy
Ramble Rmbl
Range Rge
Reach Rch
Reservation Res
Reserve Res
Reservoir Res
Rest Rst
Retreat Rt
Return Rtn
Ridge Rdg
Ridgeway Rgwy
Rise Ri
Riverway Rvwy
Riviera Rvra
Road Rd
Roads Rds
Roadside Rdsd
Roadway Rdwy
Robert Robt
Saint St
Saints SS
Senior Sr
Serviceway Swy
Shunt Shun
Siding Sdng
Sister Sr
Slope Slpe
Sound Snd
South S
Southeast SE
Southwest SW
Square Sq
Stairway Strwy
State Highway SH
State Route SR
Station Stn
Strand Sd
Street St
Strip Strp
Subway Sbwy
Tarn Tn
Terminal Term
Terrace Terr
Thoroughfare Thfr
Tollway Twy
Towers Twrs
Township Twp
Trace Trce
Track Tr
Trail Trl
Trailer Trlr
Triangle Tri
Trunkway Tkwy
Tunnel Tun
Turn Trn
Turnpike Tpk
Underpass Ups
University Uni
Upper Upr
Vale Va
Valley Vy
Viaduct Via
View Vw
Village Vill
Villas Vlls
Vista Vst
Walk Wk
Walkway Wky
Waters Wtr
Way Wy
West W
Wharf Whrf
William Wm
Wynd Wyn
Yard Yd

Canada

Extended word Synonym/Abbreviation
Autoroute aut
Avenue av
Boulevard blvd
Centre ctr
Chemin ch
Circle cir
Circuit circt
Corners crnrs
Court crt
Crescent cres
Crossing cross
Cul-de-sac cds
Diversion divers
Drive dr
Esplanade espl
Expressway expy
Extension exten
Freeway fwy
Gardens gdns
Harbour harbr
Heights hts
Highlands hghlds
Highway hwy
Impasse imp
Landing landng
Limits lmts
Mountain mtn
Orchard orch
Park pk
Parkway pky
Passage pass
Pathway ptway
Place pl
Plateau plat
Point pt
Private pvt
Range rg
Road rd
Rond-point rdpt
Route rte
Ruelle rle
Sentier sent
Square sq
Street st
Subdivision subdiv
Terrace terr
Terrasse tsse
Thicket thick
Townline tline
Turnabout trnabt

Australia

Extended word Synonym/Abbreviation
Access Accs
Air Force Base AFB
Air National Guard Base ANGB
Airport Aprt
Alley Al
Alleyway Alwy
Amble Ambl
Apartments Apts
Arcade Arc
Arterial Artl
Artery Arty
Avenue Ave
Back Bk
Banan Ba
Beach Bch
Bend Bnd
Block Blk
Boardwalk Bwlk
Boulevard Blvd
Boundary Bdy
Bowl Bl
Brace Br
Brae Br
Break Brk
Broadway Bway
Brook Brk
Brow Brw
Business Bus
Bypass Bypa
Byway Bywy
Caravan Cvn
Central Ctrl
Centre Ctr
Centreway Cnwy
Chase Ch
Church Ch
Circle Cir
City Cty
Close Cl
Community Comm
Copse Cps
Corso Cso
Cottages Cotts
County Co
County Road CR
County Route CR
Court Ct
Courtyard Ctyd
Croft Cft
Cross Cs
Crossing Xing
Crossroad Crd
Crossway Cowy
Curve Cve
Cutting Cutt
Dale Dle
Deviation Devn
Distributor Dstr
Down Dn
Downs Dn
Drive Dr
Driveway Drwy
East E
Edge Edg
Elbow Elb
Entrance Ent
Esplanade Esp
Estate Est
Expressway Expwy
Extension Ex
Father Fr
Ferry Fy
Field Fd
Fire Track Ftrk
Firetrail Fit
Flat Fl
Follow Folw
Footway Ftwy
Foreshore Fshr
Formation Form
Fort Ft
Freeway Fwy
Front Frnt
Frontage Fr
Garden Gdn
Gardens Gdn
Gateway Gwy
George Geo
Glade Gl
Glen Gln
Grange Gra
Ground Grnd
Grove Gr
Grovet Gr
Gully Gly
Harbor Hbr
Harbour Hbr
Haven Hvn
Head Hd
Heads Hd
Heights Hgts
High School HS
Highway Hwy
Hill Hl
Hills Hls
Hospital Hosp
House Ho
Industrial Ind
Interchange Intg
International Intl
Island Is
Junction Jnc
Junior Jr
Lagoon Lgn
Lakes L
Landing Ldg
Lane Ln
Laneway Lnwy
Line Ln
Link Lk
Lodge Ldg
Lookout Lkt
Loop Lp
Mall Ml
Manor Mnr
Mansions Mans
Market Mkt
Mead Md
Meadow Mdw
Meadows Mdws
Medical Med
Memorial Mem
Mews Mw
Middle Mid
Middle School MS
Mile Mi
Military Mil
Motorway Mwy
Mount Mt
Mountain Mtn
Mountains Mtn
Municipal Mun
Museum Mus
National Park NP
National Recreation Area NRA
National Wildlife Refuge Area NWRA
Nook Nk
North N
Northeast NE
Northwest NW
Outlook Out
Parade Pde
Paradise Pdse
Park Pk
Parklands Pkld
Parkway Pkwy
Pass Ps
Passage Psge
Pathway Pway
Piazza Piaz
Pike Pk
Place Pl
Plain Pl
Plains Pl
Plateau Plat
Plaza Pl
Pocket Pkt
Point Pt
Port Pt
Post Office PO
Precinct Pct
Quay Qy
Quays Qy
Ramble Rmbl
Range Rge
Reach Rch
Reservation Res
Reserve Res
Reservoir Res
Rest Rst
Retreat Rt
Return Rtn
Ridge Rdg
Ridgeway Rgwy
Rise Ri
Riverway Rvwy
Riviera Rvra
Road Rd
Roads Rds
Roadside Rdsd
Roadway Rdwy
Robert Robt
Saint St
Saints SS
Senior Sr
Serviceway Swy
Shunt Shun
Siding Sdng
Sister Sr
Slope Slpe
Sound Snd
South S
Southeast SE
Southwest SW
Square Sq
Stairway Strwy
State Highway SH
State Route SR
Station Stn
Strand Sd
Street St
Strip Strp
Subway Sbwy
Tarn Tn
Terminal Term
Terrace Terr
Thoroughfare Thfr
Tollway Twy
Towers Twrs
Township Twp
Trace Trce
Track Tr
Trail Trl
Trailer Trlr
Triangle Tri
Trunkway Tkwy
Tunnel Tun
Turn Trn
Turnpike Tpk
Underpass Ups
University Uni
Upper Upr
Vale Va
Valley Vy
Viaduct Via
View Vw
Village Vill
Villas Vlls
Vista Vst
Walk Wk
Walkway Wky
Waters Wtr
Way Wy
West W
Wharf Whrf
William Wm
Wynd Wyn
Yard Yd

Germany

Extended word Synonym/Abbreviation
Iam a
Allgemeines AKH
Altstoffsammelzentrum ASZ
auf ad
Bach B
Bad B
Bahnhof Bhf
Berg B
Bezirk Bez
Brücke Br
Bundesgymnasium BG
Bundespolizeidirektion BPD
Bundesrealgymnasium BRG
burgenländische bgld
burgenländischer bgld
burgenländisches bgld
Bürgermeister Bgm
Chaussee Ch
deutsche dt
deutsches dt
Deutscher DAV
Alpenverein DAV
Deutsch Dt
Denkmal Dkm
Dorf Df
Doktor Dr
ehemalige ehem
ehemaliger ehem
ehemaliges ehem
Fabrik Fb
Fachhochschule FH
Freiwillige FF
Feuerwehr FF
Forsthaus Fh
Gasse G
Gasthaus Gh
Gasthof Ghf
Gemeinde Gde
Graben Gr
Großer Gr
Große Gr
Großes Gr
Handelsakademie HAK
Handelsschule HASCH
Haltestelle Hst
Hauptbahnhof Hbf
Haus Hs
Heilige Hl
Heiliger Hl
Heiliges Hl
Hintere Ht
Hinterer Ht
Hinteres Ht
Hohe H
Hoher H
Hohes H
Technische HTL
Lehranstalt HTL
Hütte Htt
Internationale Int
Internationaler Int
Internationales Int
Jagdhaus Jh
Jagdhütte Jhtt
Kapelle Kpl
Katastralgemeinde KG
Kläranlage KA
Kleiner kl
Kleine kl
Kleines kl
Kleingartenanlage KGA
Kleingartenverein KGV
Kogel Kg
Konzentrationslager KL
Krankenhaus KH
Kreuz Kz
Landeskrankenhaus LKH
Maria Ma
Magister Mag
Magistratsabteilung MA
Markt Mkt
Müllverbrennungsanlage MVA
Nationalpark NP
Naturschutzgebiet NSG
Neue NMS
Mittelschule NMS
Niedere Nd
Niederer Nd
Niederes Nd
Niederösterreichische
Niederösterreichischer
Niederösterreichisches
Nummer Nr
ob o
Oberer ob
Obere ob
Oberes ob
Oberösterreichische
Oberösterreichischer
Oberösterreichisches
Österreichische Öst
Österreichischer Öst
Österreichisches Öst
Gebirgsverein ÄGV
Touristenklub ÄTK
Pater P
Pfad P
Platz Pl
Professor Prof
Quelle Q
Reservoir Res
Rhein Rh
Rundwanderweg RWW
Ruine R
Sandgrube SG
Schottergrube SG
Sankt St
Schloss Schl
See S
Siedlung Sdlg
Sozialmedizinisches SMZ
Zentrum SMZ
Spitze Sp
Steinbruch Stb
Stiege Stg
Straße Str
Strasse Str
Südliche südl
Südlicher südl
Südliches südl
Unterer unt
Untere unt
Unteres unt
Teich T
Unfallkrankenhaus UKH
Universität Uni
verfallen verf
Vordere Vd
Vorderer Vd
Vorderes Vd
von vd
Volksschule VS
Wald W
Wasserfall Wsf
Weg W
westliche westl
westlicher westl
westliches westl
Wiener Wr
Wiese Ws
Wirtschaftsuniversität WU
Wirtshaus Wh
zum z

Denmark

Extended word Synonym/Abbreviation
Lille Ll
Nordre Ndr
Søndre Sdr
Store St
Gammel Gl

Estonia

Extended word Synonym/Abbreviation
Maantee mnt
Puiestee pst
Raudtee rdt
Raudteejaam rdtj
Tänav tn

Spain

Extended word Synonym/Abbreviation
Acceso Acces
Acequia Aceq
Alameda Alam
Alquería Alque
Andador Andad
Angosta Angta
apartament apmt
Apartamentos Aptos
apartat apt
Apeadero Apdro
Arboleda Arb
Arrabal Arral
Arroyo Arry
autopista auto
Autovía Autov
autovia autov
Avenida Av
avinguda av
baixada bda
baixos bxs
Bajada Bjada
Balneario Balnr
Banda Bda
barranc bnc
Barranco Branc
Barranquil Bqllo
barri b
biblioteca bibl
bloc bl
Bloque Blque
Brazal Brzal
Bulevar Bulev
Calleja Cllja
Callejuela Cjla
Callizo Cllzo
Calzada Czada
Camino Cno
Camino hondo CH
Camino nuevo CN
Camino viejo CV
Camping Campg
Cantón Cant
Cantera Cantr
Cantina Canti
cantonada cant
carreró cró
Carrera Cra
Carrero Cro
Carreterín Ctrin
Carretil Crtil
Carril Crril
Caserío Csrio
cementiri cem
Chalet Chlet
cinturó cint
Cinturón Cint
Circunvalación Ccvcn
Cobertizo Cbtiz
codi postal CP
col·legi col·l
col·legi públic CP
Colonia Col
comissaria com
Complejo Compj
Conjunto Cjto
convent convt
Convento Cnvto
Cooperativa Coop
Corral Crral
Corralillo Crrlo
Corredor Crrdo
correus corr
Cortijo Crtjo
Costanilla Cstan
Costera Coste
Cuadra Cuadr
Cuesta Custa
Dehesa Dhsa
Demarcación Demar
Diagonal Diag
Diseminado Disem
districte distr
drecera drec
dreta dta
Edificio Edifc
Empresa Empr
entrada entr
entresol entl
Errepidea Err
escala esc
Escalera Esca
Escalinata Escal
escola esc
escola universitöria EU
església esgl
Espalda Eslda
estació est
Estación Estcn
estacionament estac
Estrada Estda
Etorbidea Etorb
Explanada Expla
Extramuros Extrm
Extrarradio Extrr
Fàbrica Fca
facultat fac
finca fca
Galería Gale
Glorieta Gta
Gran Vía GV
Granja Granj
habitació hab
Hipódromo Hipod
hospital hosp
hotel H
Jardín Jdin
Kalea K
Ladera Ldera
Llanura Llnra
Malecón Malec
Mercado Merc
Mirador Mrdor
Monasterio Mtrio
monestir mtir
monument mon
mossèn Mn
Muelle Muell
municipal mpal
museu mus
nacional nac
Núcleo Ncleo
número núm
nombre nre
Pórtico Prtco
Palacio Palac
Pantano Pant
parada par
Paraje Praje
parcel‡la parc
Parque Pque
Particular Parti
Partida Ptda
Pasadizo Pzo
Pasaje Psaje
Paseo P
Paseo marítimo Psmar
Pasillo Psllo
passadís pdís
passatge ptge
passeig pg
pavelló pav
planta pl
Plaza Pl
Plazoleta Pzta
Plazuela Plzla
població pobl
Poblado Pbdo
polígon pol
polígon industrial PI
porta pta
portal ptal
Portillo Ptilo
Prazuela Przla
principal pral
Pueblo Pblo
Puente Pnte
Puerta Pta
Puerto Pto
pujada pda
punt quilomètric PK
Punto kilom_trico pk
rambla rbla
Rampla Rampa
Residencial Resid
Ribera Rbra
Rincón Rcon
Rinconada Rcda
ronda rda
Rotonda Rtda
sagrada sgda
sagrat sgt
San S
Sanatorio Sanat
sant st
santa sta
Santuario Santu
Sector Sect
Sendera Sedra
Sendero Send
sortida sort
Subida Sbida
Torrente Trrnt
Trànsito Trans
Transversal Trval
Trasera Tras
Travesía Trva
travessera trav
travessia trv
urbanització urb
Urbanización Urb
Vecindario Vecin
Vereda Vreda
via v
Viaducto Vcto
Viviendas Vvdas

Finland

Extended word Synonym/Abbreviation
alue al
aukio auk
kaari kri
katu k
kuja kj
kylä kl
penger pgr
polku p
puistikko pko
puisto ps
raitti r
ranta rt
rinne rn
taival tvl
tie t
tori tr
väylä vlä

Finland

Extended word Synonym/Abbreviation
Abbaye ABE
Aires AIRE
Allées ALL
Ancien chemin ACH
Ancienne route ART
Anciennes routes ART
Arcade ARC
Arcades ARC
Autoroute AUT
Avenue AV
Barrière BRE
Barrières BRE
Bas chemin BCH
Bastide BSTD
Baston BAST
Béguinage BEGI
Béguinages BEGI
Berge BER
Berges BER
Boucle BCLE
Boulevard Bd
Bourg BRG
Butte BUT
Cité CITE
Cités CITE
Côte COTE
Côteau COTE
Campagne CGNE
Camping CPG
Carreau CAU
Carrefour CAR
Carrière CARE
Carrières CARE
Carré CARR
Castel CST
Cavée CAV
Central CTRE
Centre CTRE
Chalet CHL
Chapelle CHP
Charmille CHI
Chaussée CHS
Chaussées CHS
Chemin Ch
Chemin vicinal CHV
Cheminement CHEM
Cheminements CHEM
Chemins CHE
Chemins vicinaux CHV
Château CHT
Cloître CLOI
Colline COLI
Collines COLI
Contour CTR
Corniche COR
Corniches COR
Cottage COTT
Cottages COTT
Cours Crs
Darse DARS
Degré DEG
Degrés DEG
Descente DSG
Descentes DSG
Digue DIG
Digues DIG
Domaine DOM
Domaines DOM
Enceinte EN
Enclave ENV
Enclos ENC
Escalier ESC
Escaliers ESC
Espace ESPA
Esplanade ESP
Esplanades ESP
Étang ETANG
Faubourg Fg
Ferme FRM
Fermes FRM
Fontaine FON
Forum FORM
Fosse FOS
Fosses FOS
Foyer FOYR
Galerie GAL
Galeries GAL
Garenne GARN
Grand boulevard GBD
Grand ensemble GDEN
Granderue GR
Grande rue GR
Grandes rues GR
Grands ensembles GDEN
Grille GRI
Grimpette GRIM
Groupe GPE
Groupement GPT
Groupes GPE
Halle HLE
Halles HLE
Hameau HAM
Hameaux HAM
Haut chemin HCH
Hauts chemins HCH
Hippodrome HIP
Île ILE
Immeuble IMM
Immeubles IMM
Impasse IMP
Impasses IMP
Jardin JARD
Jardins JARD
Jetée JTE
Jetées JTE
Levée LEVE
Lieu-dit LD
Lotissement LOT
Lotissements LOT
Maison forestière MF
Manoir MAN
Marche MAR
Marches MAR
Monseigneur Mgr
Mont Mt
Montée MTE
Montées MTE
Moulin MLN
Moulins MLN
Musée MUS
Nouvelle route NTE
Palais PAL
Parcs PARC
Parking PKG
Parvis PRV
Passage PAS
Passage à niveau PN
Passe PASS
Passerelle PLE
Passerelles PLE
Passes PASS
Patio PAT
Pavillon PAV
Pavillons PAV
Petit chemin PCH
Petite allée PTA
Petite avenue PAE
Petite impasse PIM
Petite route PRT
Petite rue PTR
Petites allées PTA
Place PL
Placis PLCI
Plage PLAG
Plages PLAG
Plaine PLN
Plateau PLT
Plateaux PLT
Pointe PNT
Ponts PONT
Porche PCH
Porte PTE
Portique PORQ
Portiques PORQ
Poterne POT
Pourtour POUR
Presqu'ile PRQ
Promenade PROM
Quai Qu
Quartier QUA
Raccourci RAC
Raidillon RAID
Rampe RPE
Rempart REM
Rocade ROC
Rond point RPT
Roquet ROQT
Rotonde RTD
Route RTE
Routes RTE
Rue R
Ruelle RLE
Ruelles RLE
Rues R
Résidence RES
Résidences RES
Saint St
Sainte Ste
Sente SEN
Sentes SEN
Sentier SEN
Sentiers SEN
Square SQ
Stade STDE
Station STA
Terrain TRN
Terrasse TSSE
Terrasses TSSE
Terre plein TPL
Tertre TRT
Tertres TRT
Traverse TRA
Vallon VAL
Vallée VAL
Venelle VEN
Venelles VEN
Vieille route VTE
Vieux chemin VCHE
Villa VLA
Village VGE
Villages VGE
Villas VLA
Voie VOI
Voies VOI
Zone artisanale ZA

Italy

Extended word Synonym/Abbreviation
Calle C.le
Campo C.po
Corso C.so
Corte C.te
Fondamenta F.ta
Largo L.go
Località Loc.
Piazza P.za
Piazza P.zza
Piazzale P.le
Piazzetta P.ta
Ponte P.te
Porta P.ta
Salizada S.da
Stazione Staz.
Strada Comunale SC
Strada Provinciale SP
Strada Regionale SR
Strada Statale SS
Via V.
Viale V.le
Vicolo V.lo

Madagascar

Extended word Synonym/Abbreviation
Ambato Ato
Ambinany Any
Ambodi Adi
Ambohi Ahi
Ambohitr Atr
Ambony Ani
Ampasi Asi
Andoha Aha
Andrano Ano

Malaysia

Extended word Synonym/Abbreviation
Jalan Jln
Simpang Spg
Kampong Kg
Sungai Sg
Haji Hj
Pengiran Pg
Awang Awg
Dayang Dyg

Netherlands

Extended word Synonym/Abbreviation
Broeder Br
Burgemeester Burg
Dominee ds
Gebroeders Gebr
Generaal Gen
Gracht gr
Jonkheer Jhr
Kolonel Kol
Kanunnik Kan
Kardinaal Kard
Kort Kte
Koning Kon
Koningin Kon
Laan ln
Lange L
Luitenant Luit
Markt mkt
Meester mr
Mejuffrouw Mej
Mevrouw Mevr
Minister Min
Monseigneur Mgr
Noordzijde NZ
Oostzijde OZ
Pastoor Past
Plein pln
President Pres
Prins Pr
Prinses Pr
Professor Prof
Singel sngl
Straat str
Steenweg stwg
Sint St
Van V
Van De vd
Van Den V
Van Der V
Verlengde Verl
Vliet vlt
Vrouwe Vr
Weg wg
Westzijde WZ
Zuidzijde Z
Zuster Zr

Norway

Extended word Synonym/Abbreviation
vei v
veien v
veg v
vegen v
vei vn
veien vn
veg vn
vegen vn
gate g
gaten g
gata g
gate gt
gaten gt
gata gt
plass pl
plassen pl
sving sv
svingen sv

New Zealand

Extended word Synonym/Abbreviation
Access Accs
Air Force Base AFB
Air National Guard Base ANGB
Airport Aprt
Alley Al
Alleyway Alwy
Amble Ambl
Apartments Apts
Arcade Arc
Arterial Artl
Artery Arty
Avenue Ave
Back Bk
Banan Ba
Beach Bch
Bend Bnd
Block Blk
Boardwalk Bwlk
Boulevard Blvd
Boundary Bdy
Bowl Bl
Brace Br
Brae Br
Break Brk
Broadway Bway
Brook Brk
Brow Brw
Business Bus
Bypass Bypa
Byway Bywy
Caravan Cvn
Central Ctrl
Centre Ctr
Centreway Cnwy
Chase Ch
Church Ch
Circle Cir
City Cty
Close Cl
Community Comm
Copse Cps
Corso Cso
Cottages Cotts
County Co
County Road CR
County Route CR
Court Ct
Courtyard Ctyd
Croft Cft
Cross Cs
Crossing Xing
Crossroad Crd
Crossway Cowy
Curve Cve
Cutting Cutt
Dale Dle
Deviation Devn
Distributor Dstr
Down Dn
Downs Dn
Drive Dr
Driveway Drwy
East E
Edge Edg
Elbow Elb
Entrance Ent
Esplanade Esp
Estate Est
Expressway Expwy
Extension Ex
Father Fr
Ferry Fy
Field Fd
Fire Track Ftrk
Firetrail Fit
Flat Fl
Follow Folw
Footway Ftwy
Foreshore Fshr
Formation Form
Fort Ft
Freeway Fwy
Front Frnt
Frontage Fr
Garden Gdn
Gardens Gdn
Gateway Gwy
George Geo
Glade Gl
Glen Gln
Grange Gra
Ground Grnd
Grove Gr
Grovet Gr
Gully Gly
Harbor Hbr
Harbour Hbr
Haven Hvn
Head Hd
Heads Hd
Heights Hgts
High School HS
Highway Hwy
Hill Hl
Hills Hls
Hospital Hosp
House Ho
Industrial Ind
Interchange Intg
International Intl
Island Is
Junction Jnc
Junior Jr
Lagoon Lgn
Lakes L
Landing Ldg
Lane Ln
Laneway Lnwy
Line Ln
Link Lk
Lodge Ldg
Lookout Lkt
Loop Lp
Mall Ml
Manor Mnr
Mansions Mans
Market Mkt
Mead Md
Meadow Mdw
Meadows Mdws
Medical Med
Memorial Mem
Mews Mw
Middle Mid
Middle School MS
Mile Mi
Military Mil
Motorway Mwy
Mount Mt
Mountain Mtn
Mountains Mtn
Municipal Mun
Museum Mus
National Park NP
National Recreation Area NRA
National Wildlife Refuge Area NWRA
Nook Nk
North N
Northeast NE
Northwest NW
Outlook Out
Parade Pde
Paradise Pdse
Park Pk
Parklands Pkld
Parkway Pkwy
Pass Ps
Passage Psge
Pathway Pway
Piazza Piaz
Pike Pk
Place Pl
Plain Pl
Plains Pl
Plateau Plat
Plaza Pl
Pocket Pkt
Point Pt
Port Pt
Post Office PO
Precinct Pct
Quay Qy
Quays Qy
Ramble Rmbl
Range Rge
Reach Rch
Reservation Res
Reserve Res
Reservoir Res
Rest Rst
Retreat Rt
Return Rtn
Ridge Rdg
Ridgeway Rgwy
Rise Ri
Riverway Rvwy
Riviera Rvra
Road Rd
Roads Rds
Roadside Rdsd
Roadway Rdwy
Robert Robt
Saint St
Saints SS
Senior Sr
Serviceway Swy
Shunt Shun
Siding Sdng
Sister Sr
Slope Slpe
Sound Snd
South S
Southeast SE
Southwest SW
Square Sq
Stairway Strwy
State Highway SH
State Route SR
Station Stn
Strand Sd
Street St
Strip Strp
Subway Sbwy
Tarn Tn
Terminal Term
Terrace Terr
Thoroughfare Thfr
Tollway Twy
Towers Twrs
Township Twp
Trace Trce
Track Tr
Trail Trl
Trailer Trlr
Triangle Tri
Trunkway Tkwy
Tunnel Tun
Turn Trn
Turnpike Tpk
Underpass Ups
University Uni
Upper Upr
Vale Va
Valley Vy
Viaduct Via
View Vw
Village Vill
Villas Vlls
Vista Vst
Walk Wk
Walkway Wky
Waters Wtr
Way Wy
West W
Wharf Whrf
William Wm
Wynd Wyn
Yard Yd

Poland

Extended word Synonym/Abbreviation
Aleja al
Aleje al
Aleji al
Alejach al
Dolny Dln
Dolna Dln
Dolne Dln
Drugi II
Druga II
Drugie II
Duży Dz
Duża Dz
Duże Dz
Górny Grn
Górna Grn
Górne Grn
Kolonia kol
koło k
kolo k
Mały Ml
Mała Ml
Małe Ml
Mazowiecka maz
Mazowiecki maz
Mazowieckie maz
Miasto m
Nowy Nw
Nowa Nw
Nowe Nw
Osiedle os
Osiedlu os
Pierwszy I
Pierwsza I
Pierwsze I
Plac pl
Placu pl
Placem pl
Stary St
Stara St
Stare St
Świętego sw
Świętej Str
Świętych Str
Trzeci III
Trzecia III
Trzecie III
Ulica ul
Ulice ul
Uliczny ul
Ulicy ul
Wielki Wlk
Wielka Wlk
Wielkie Wlk
Wielkopolski wlkp
Wielkopolska wlkp
Wielkopolskie wlkp
Województwo woj
Województwie woj
Kardynała kard
Marszałka marsz
Generała gen
księdza ks
doktora dr
Majora mjr
Biskupa bpa

Portugal

Extended word Synonym/Abbreviation
Alameda Al
Alferes Alf
Almirante Alm
Arquitecto Arq
Arquiteto Arq
Auto-estrada A
Avenida Av
Azinhaga Az
Bairro Br
Beco Bc
Bloco Bl
Brigadeiro Brg
Cacique Cac
Caminho Cam
Capitão Cap
Casal Csl
Cave Cv
Centro Comercial CC
Comandante Cmdt
Comendador Comend
Conselheiro Cons
Coronel Cor
Deputado Dep
Direito Dto
Dom D
Dona D
Doutor Dr
Doutora Dr
Duque Dq
Edifício Edf
Embaixador Emb
Escadas Esc
Escadinhas Escnh
Esquerdo Esq
Estrada Estr
Estrada Municipal EM
Estrada Nacional EN
Estrada Regional ER
Frei Fr
Frente Ft
Futebol Clube FC
General Gen
Habitação Hab
Infante Inf
Instituto Inst
Jardim Jrd
Jœnior Jr
Largo Lg
Limitada Lda
Loja Lj
Lote Lt
Loteamento Loteam
Lugar Lug
Maestro Mto
Major Maj
Marechal Mal
Marquês Mq
Madre Me
Mestre Me
Ministério Min
Monsenhor Mons
Municipal M
Nacional N
Nossa N
Nossa Senhora Ns
Nosso N
Nœmero N
Padre Pe
Parque Pq
Particular Part
Pavilhão Pav
Praceta Pct
Presidente Presid
Professor Prof
Professora Prof
Projectada Proj
Projetada Proj
Prolongamento Prolng
Quadra Qd
Quinta Qta
Regional R
Rotunda Rot
Ribeira Rib
Rio R
Rua R
Santo St
São S
Sargento Sarg
Sem Nœmero Sn
Senhor Sr
Senhora Sra
Sociedade Soc
Superquadra Sq
Tenente Ten
Torre Tr
Transversal Transv
Travessa Trv
Universidade Univ
Urbanização Urb
Vila Vl
Visconde Visc
Vivenda Vv
Zona Zn

Romania

Extended word Synonym/Abbreviation
Aleea al
Bulevardul blv
Calea cal
Intrarea intr
Piata pta
Strada str
Soseaua sos
Splaiul spl
Varful vf
Muntele mt

Sweden

Extended word Synonym/Abbreviation
stig st
stigen st
sankt s:t
sankta s:ta
plats pl
platsen pl
lilla l
stora st
väg v
vägen v
gatan g
gata g
gränd gr
gränden gr

Slovenia

Extended word Synonym/Abbreviation
Cesta C
Spodnja Sp
Spodnje Sp
Spodnji Sp
Srednja Sr
Srednje Sr
Srednji Sr
Sveta Sv
Sveti Sv
Ulica Ul
Velika V
Velike V
Veliki V
Veliko V
Zgornja Zg
Zgornje Zg
Zgornji Zg

Slovakia

Extended word Synonym/Abbreviation
Ulica Ul
Námestie Nám
Svätého Sv
Svätej Sv
Generála Gen
Armádneho generála Arm. gen
Doktora Dr
Doktorky Dr
Inginiera Ing
Inginierky Ing
Majora Mjr
Profesora Prof
Profesorky Prof
Československej Čsl
Plukovníka Plk
Podplukovníka Pplk
Kapitána Kpt
Poručíka Por
Podporučíka Ppor
Sídlisko Sídl
Nábrečie Nábr

Turkey

Extended word Synonym/Abbreviation
Sokak Sk
Sokak Sok
Sokaki Sk
Sokaki Sok
Cadde Cd
Caddesi Cd
Bulvar Bl
Bulvari Bl

Search providers

Integrating additional search providers

Specific details regarding integrating new search providers & capabilities can be found in the SDKTools specific documentation (Android and iOS)

Reverse geocoding

For reverse geocoding (searching for coordinates: "42.32207, -83.17628") one must use the specific reverse geocoding API