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.

Note: Not all formats work may work for every country.

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.
Note: Not all of these address elements are used in every country.

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.

Note: Non-delimited or partially-delimited single line addresses may take longer to geocode and may not produce the same results as delimited single line input. This is especially true for addresses with multi-word street names or cities. To optimize single line geocoding, use delimiters between address elements (particularly between street name and city).

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>

where:
  • 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.
Note: Block and lot numbers are the most specific address elements in Japan. Japanese addresses typically do not have street names.
Table 1. Example Japanese Addresses
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.