Single Line Input
Instead of entering each address element in separate fields, you may enter the entire address in the AddressLine1 input field.
For all countries except Japan, you can enter addresses in one or more of these single-line formats.
StreetAddress;PostalCode;City
StreetAddress;City;PostalCode
StreetAddress;City
StreetAddress;City;StateProvince;PostalCode
StreetAddress;Locality
StreetAddress;County;City
PostalCode;StreetAddress
PostalCode;StreetAddress;City
City;PostalCode;StreetAddress
Where:
- StreetAddress can be house number and street name in either order (with street type immediately before or after the street name).
- City is the town. For Indonesia and Thailand, this is the subdistrict.
- Locality is the locality name. For Indonesia, this is the village.
- County is the county or local administrative name. For Chile, Philippines, and Thailand, this is the district. For Indonesia, this is the regency/city.
- StateProvince is the postal abbreviation for the state or province.
- PostalCode is the complete postcode. For Brazil, PostalCode should be the complete eight-digit postcode for the most accurate results. However, you can use a five-digit postcode.
Other single-line formats may also be acceptable for many countries.
The matching accuracy for single line input is comparable to that of structured address input. The performance of single line input addresses may be slightly slower than that of structured address input.
For best results, use delimiters (comma, semicolon, or colon) between each address element. For example,
Appeldam Oranjestad
Rua JOSE Anchieta;Luanda
University City Road Dubai
طريق المدينة الجامعية دبي
Capital Federal;Av. Corrientes;3702
18 Merivale St,South Brisbane,QLD,4101
Alser Strasse 16,1090,Wien
Boulevard Du 28 Novembre;Bujumbura
Sint-Jacobsstraat,49;8900;YPRES
Rue 1823; Cotonou
Rue 28.263 Ouagadougou
Shaikh Khalifa Bin Mohammad Street Al Moharraq
شارع الشيخ خليفة بن محمد المحرق
27 Guadeloape Street, Nassau
14th Street San Ignacio
Radnor Drive Hamilton
Calle 15 Santa Cruz de la Sierra
AV BICO TORTO,SERRA,29168334
Bonnetts Road Saint Michael
Kushimbara Road;Gaborone
26 Wellington Street East;Toronto;ON;M5E 1S2
1 Rue Halimand;1003;Lausanne
Camino Nueva La Rural 3905 9200000 Cerrillos
Yayingshi Rd,5100
Avenue du Docteur Jamot;Douala
Boulevard Patrice Lumumba;Kinshasa
Avenue Coutassi;Brazzaville
Ruta 125 40405 Santo Domingo
Calle 30 Ciudad de la Habana
Krehlíkova 92,Brno 62700
schulstrasse 22,Dresden,01328
Gettrupvej 41,Holsted,6670
Calle 7 71101 San Cristobal
Hermano Miguel 2 Quito
Gamal Soliman Abu Soliman Street, Abou Ilghait
شارع جمال سليمان ابو سليمان أبو الغيط
Paseo de la Castellana 210,Madrid
Põhja Puiestee 23,10111
Framnäsvägen 16;02230;Espoo
131 rue de la République;La Défense
Avenue Gabriel Lendoye;Libreville
Flat 69 Victoria Street,Windsor,SL4 1EH
Leoforos Achaion 145 19009 Agia Triada
7 Avenida Villa Nueva
North Road Georgetown
Ignjata Joba 6, Dubrovnik, 20000
Pasaje B San Pedro Sula
Szegedi Gergely Utca 13,Debrecen,4000
JL Pecenongan, 10120
Gunjur Road,Marattahalli,560017
7 Irvine Court,East Wall
Jamila Street;Baghdad
Salthamrar 1 112 Reykjavík
Via del Canneto,03011
Queen Street 1 Kingston
Al Ebshehi Street Amman
Taratibu Street;Mombasa
Wellington Road St. Peter Basseterre
First Circular Road, Green Belt
طريق الدائري الاول الحزام الاخضر
Shaikh Sabah Il-Salem Il-Sabah Street, Beirut
بيروت;شارع الشيخ صباح السالم الصباح بيروت
Mpilo Road; Maseru
Slengiu gatve 19, Klaipeda, 91001
Jâtnieku 79;Daugavpils;LV-5410
1 Rua Do Delegado;Nossa Senhora do Carmo
Avenue Moukhtar Soussi; 28630 Ain Harrouda
Urión 30,Col. Tlatilco,02860,Mexico,D.F.
Rue 97;Bamako
Avenida 24 De Julho;Maputo
Rue Ely ould Mohamed;Nouakchott
Victor Hugo Street Beau;Bassin
Presidential Way;Lilongwe
Jalan Chowrasta;10100;Seksyen 15
Katanga Street;Swakopmund
Avenue de I'Afrique;Niamey
39 Avenida NE Managua
Limpopo Street;Abuja
Dijkerstraat 40,Weert,6006
Ovre Varg Vei 17,3124,Tonsberg
56 Namata Road;One Tree Hill;Auckland;2001
Arab league Street, Masqat
شارع جامعة الدول العربية مسقط
Avenida 4 De Julio Ciudad de Panamá
Calle Felipe 101 31 Lima
Pleasant Drive, Caloocan City
1 Maja 34;58260;Bielawa
Rua Alegre 79;4150;Porto
Artigas 2801 Asunción
Ahmed Bin Mohammad Bin Thany Street, Doha
شارع احمد بن محمد بن ثاني الدوحة
BULEVARDUL 1907 61 Giurgiu
53 Myakininskaya 5-ya ulitsa; 143420; Krasnogorsk
Avenue De La Gendarmerie;Kigali
King Faisal Bin Abdel Aziz Road, Hafr Il-Batin
طريق الملك فيصل بن عبدالعزيز حفر الباطن
Rue GY 501; Dakar
Boat Quay,Downtown Core,040000
Calle Padres Aguila, San Salvador
Henrystraat 8 Paramaribo
Brezová 6 Sliac 90000
celjskih knezov 9,3000,Celje
Frescativägen 33,10405,Stockholm
Mbangweni Street; Mbabane
Samsen Rd;Tanon Nakorn Chaisri;10300
De La Marina Boulevard;Lomé
Angelina San Juan-Laventille
Rue Aflatoun Ben;Arous
1631 4 Sokak 14,06020,Sancaktepe
202 Rueilong Road, 806, Cianjhen District
Kiyungi Street;Dar es Salaam
Rubaga Road; Kampala
Sadovyi provulok 24 Irpin
Calle Dr Teofilo Diaz, Colón Centro y Noroeste, Montevideo
calle Valdez Valencia
590 Lighthouse,Fynnlands
Freedom Way, Kitwe
Kirwith Road, Bulawayo
If the input address is missing delimiters, spaces are recognized as separators and internal parsing rules identify address elements. In the example above, the address would still successfully geocode even if some or all of the delimiters were missing in the input.
Punctuation is ignored for geocoding purposes.
Format for Japan
Japanese addresses are typically written in single line format, without any delimiters to separate address fields. The typical format is:
<prefecture><city><municipality subdivision><city district><block><lot><other>
- prefecture = ken
- city = shi
- municipality subdivision = oaza
- city district = chome
- block = numbered city block (ban)
- lot = sub blocks or building number (go)
- other = building names, flat numbers, or other identifiers. This information is ignored by the Japan geocoder.
Address | Description |
---|---|
Chome, block, and lot separated by a hyphens. | |
Block and lot separated by hyphen, chome indicated by chome identifier. | |
Chome, block, and lot separated by their identifiers. |
Guidelines for Single Line Input
- For Great Britain, single line input is supported with the CodePoint (CP) and AddressPoint (AP) datasets. Single line is not supported with the Streets (TomTom source) dataset.
- For Germany, France, and New Zealand, yYou must specify a value in either the PostalCode field or the City field in order for single line input to successfully geocode.
- For Canada, iIf you omit the postal code and country, the geocoder still geocodes the address based on street address, city, and province.
- Punctuation is generally ignored, however you may improve results and performance by using separators (commas, semicolons, etc.) between different address elements.
- The country is not required. Each country geocoder assumes that the address is in its country.
- Firm information (placename, building name, or government building) is returned if available.