Guide · Maps and addresses

Addresses and maps in a Syrian app.

Postcodes are not required in Syria, according to the Universal Postal Union. Here is how to build the address form around a map pin and a description, store a Plus Code that works offline, and choose map services after reading what their terms actually say.

Updated 18 November 2026Sources checked 16 November 2026Reviewed by Eng. Hasan Kassas

The short answer

Do not make a postcode field required for Syrian addresses. The Universal Postal Union lists Syria among the countries that do not require postal codes, and we found no official Syrian document from 2025 or 2026 that sets up a national postcode or addressing scheme. Ask instead for the governorate and city, the area, a street or landmark description, the building and floor, a mobile number, and a pin the user places on a map.

Save three things for each address: the pin as coordinates, a Plus Code the phone computes from it with no network and no API key, and the text exactly as the user typed it. For the map itself, read each vendor's terms before you build. Google Maps Platform lists Syria as a prohibited territory, several other vendors name no country and refer to export-control or embargo rules instead, and the free public OpenStreetMap servers come with strict usage limits.

Postcodes

What the postal bodies say about Syria

We checked what the Universal Postal Union (UPU) publishes and the latest request from the Syrian postal operator. In short: there is no postcode to collect, and there is a phone number you should collect.

  • UPU's addressing FAQ puts Syria in its list of countries that do not require postal codes (that table is dated September 2025). By UPU's own count, around 130 countries use postcodes in their addressing systems.
  • UPU's addressing sheet for Syria is dated September 2004. It says Syrian Post was developing a postcode system. We found no newer UPU sheet, and no 2025 or 2026 official Syrian document on a national postcode or addressing system.
  • The same sheet shows the order of a Syrian address: name; floor, apartment and building; street and number; district; town; country. Its Damascus example has a four-digit number before the city name that the sheet does not explain.
  • Codes you may see for Syrian towns on third-party lookup sites are not confirmed by any official source we could find, and they conflict with UPU's list. Do not validate addresses against them.
  • From 1 October 2026, according to the US Postal Service, the Syrian postal operator asks senders to put the addressee's mobile number and email, if possible, on international items. The lesson for an app: the phone number is part of the address. Our Syrian phone number checker shows which formats are valid.
The form

Address fields for Syrian users

Required?Why
Governorate and cityYesA pick list, not free text, so you can filter, report and route orders.
Area or neighbourhoodYesA pick list with a free-text fallback for areas you have not listed yet.
Street, or the nearest landmarkYesFree text, Arabic first. Let people describe the place the way they would describe it to a driver.
Building, floor, apartmentRecommendedShort separate fields. UPU's sample Syrian address puts them on the line right after the name.
Map pinYes, for deliveries and ridesThe user places or confirms it; the app stores the coordinates and a Plus Code.
Mobile numberYesThe courier calls when the description is not enough. See the postal operator's request above.
PostcodeNoHide it for Syrian addresses, or keep it optional.
Notes for the driverOptionalGate colour, which entrance, call on arrival.
Data model

What to save with every address

01
The pin

Latitude and longitude, plus the accuracy the phone reported, the time, and whether the user dragged the pin by hand. Those extra fields tell you later which pins to trust.

02
The Plus Code

Computed from the pin on the phone itself. It is short enough to read out on a call or paste into a chat, and it decodes back to the same spot without a network.

03
The words

Street, landmark and building text exactly as typed, in Arabic or English. Put a normalised copy in its own column for search and never show that copy to the courier.

04
Where it came from

If a geocoding service filled any field, record which one and when. Some vendors limit what you may store, as the storage section below shows.

Tested code

Plus Codes with no library and no network

A full Plus Code is computed from the coordinates alone and converts back to a location offline, with no data tables and no online service. The algorithm is open source (Apache 2.0) and the project says it may be used without restriction, so there is no API key and no account to manage. This JavaScript function turns a pin into a code, and a code back into the centre of its cell:

// Plus Codes (Open Location Code) in plain JavaScript: no library, no network.
// encodePlusCode turns a GPS position into a full code such as "8G5RG864+FJ"; decodePlusCode
// turns a full code back into the centre of its cell. Works the same offline.
const ALPHABET = "23456789CFGHJMPQRVWX";
const LAT_UNITS = 8000 * 3125; // 1/25,000,000 of a degree, the finest grid step
const LNG_UNITS = 8000 * 1024; // 1/8,192,000 of a degree

function encodePlusCode(lat, lng, length = 10) {
  if (length !== 10 && length !== 11) throw new Error("length must be 10 or 11");
  if (!Number.isFinite(lat) || !Number.isFinite(lng)) throw new Error("not a position");
  let y = Math.floor(Math.round((lat + 90) * LAT_UNITS * 1e6) / 1e6);
  let x = Math.floor(Math.round((lng + 180) * LNG_UNITS * 1e6) / 1e6);
  y = Math.min(Math.max(y, 0), 180 * LAT_UNITS - 1);
  x = ((x % (360 * LNG_UNITS)) + 360 * LNG_UNITS) % (360 * LNG_UNITS);
  let grid = "";
  for (let i = 0; i < 5; i++) { // the 11th+ digits: a 4 x 5 grid inside the cell
    grid = ALPHABET[(y % 5) * 4 + (x % 4)] + grid;
    y = Math.floor(y / 5); x = Math.floor(x / 4);
  }
  let pairs = "";
  for (let i = 0; i < 5; i++) { // the first 10 digits: latitude/longitude pairs in base 20
    pairs = ALPHABET[y % 20] + ALPHABET[x % 20] + pairs;
    y = Math.floor(y / 20); x = Math.floor(x / 20);
  }
  return pairs.slice(0, 8) + "+" + (pairs.slice(8) + grid).slice(0, length - 8);
}

function decodePlusCode(code) {
  const c = String(code).trim().toUpperCase();
  if (!/^[23456789CFGHJMPQRVWX]{8}\+[23456789CFGHJMPQRVWX]{2,3}$/.test(c)) {
    throw new Error("expected a full 10 or 11 digit Plus Code, e.g. 8G5RG864+FJ");
  }
  const d = c.replace("+", "").split("").map((ch) => ALPHABET.indexOf(ch));
  if (d[0] > 8 || d[1] > 17) throw new Error("not a valid Plus Code");
  let y = 0, x = 0, yUnits = 8000, xUnits = 8000;
  for (let i = 0; i < 10; i += 2) { y = y * 20 + d[i]; x = x * 20 + d[i + 1]; }
  if (d.length === 11) { y = y * 5 + Math.floor(d[10] / 4); x = x * 4 + (d[10] % 4); yUnits *= 5; xUnits *= 4; }
  return { lat: (y + 0.5) / yUnits - 90, lng: (x + 0.5) / xUnits - 180 };
}

Tested before publishing: on 40,000 random points (20,000 worldwide and 20,000 inside Syria's bounding box) it returns the same 10- and 11-digit codes as the JavaScript implementation from the open-location-code project (Apache 2.0), with the same decoded centres and clean round trips. 33.51123, 36.30654 in Damascus encodes to 8G5RG864+FJ (11 digits: 8G5RG864+FJV). It accepts lower case and spaces and rejects short codes and malformed input. It does not decode short codes such as G864+FJ Damascus, which need a reference location.

Plus Codes

What to know before you rely on them

  • A full code is eight characters, a plus sign, then two more: ten digits in all. Near Damascus that cell is about 14 m by 12 m. An eleventh character narrows it to about 3 m by 3 m, so use it when the entrance matters and not only the building.
  • Short codes such as G864+FJ Damascus leave out the first four characters and lean on a reference place. The project's documentation says a place-name reference may need a geocoding service to resolve, and two geocoders can put the same town far enough apart to land on the wrong cell. It suggests references at neighbourhood scale rather than city scale. The function above accepts full codes only.
  • A Plus Code gives you a location, not a street address. Geocoding is not part of the Open Location Code technology, so turning a code into a street name still needs a separate service.
  • Show the code on the order screen with copy and share buttons, so a customer can send it to a courier in a chat instead of typing it.
  • The licence is Apache 2.0, and the README says the encoding and decoding algorithms are public and usable without restriction. The repository ships implementations in Dart, Java, Go, Python and other languages, so a Flutter app and a Node server can share one set of rules.
Checked 16 November 2026

Map and geocoding providers: what their terms say about Syria

Names Syria?What the terms say
Google Maps PlatformYesIts prohibited-territories page lists Syria (checked 15 November 2026).
MapboxNo country namedProduct Terms (20 Oct 2026) require compliance with export control laws. The form Master Services Agreement (12 Sep 2025) excludes from the licensed territory any country embargoed or designated as supporting terrorism by the US Government, without a list.
HERESyria not namedPlatform Terms (effective 18 Sep 2023) forbid providing HERE materials to any embargoed destination in violation of US, UK or EU law.
MapTilerNo country namedCloud terms ask you to certify you are not a restricted person under Swiss, US, EU and UK law. MapTiler Satellite adds a warranty that you are not located in a US-embargoed country.
TomTomNo country namedDeveloper portal terms: do not accept the agreement if US or other laws bar you from receiving the products.
EsriNot on its listSyria is not on Esri's list of prohibited countries and destinations (page last modified 30 Dec 2025).
what3wordsNo country namedTerms (20 Apr 2026) and API licence (26 Oct 2026) bar use by anyone located in a country under a US trade embargo or designated by the US as terrorist-supporting.
Apple MapsNo Maps feature listedThe iOS and iPadOS 27 feature-availability page lists Syria under none of its Maps features, and does not say whether maps load there. Test on a device.
OpenStreetMap Foundation serversNo country namedIts Terms of Use (last edited 31 Oct 2018) include a sanctions representation for users of its website, tiles and Nominatim. The ODbL data licence has no such clause.
Storage

Storage rules that shape your database

  • Mapbox: the Product Terms (20 Oct 2026) forbid exporting, storing or caching Temporary Geocodes, and using geocoding results to build a general address or place database. Only Permanent Geocodes may be stored, so check which kind you request before you save a result on a customer's address.
  • MapTiler Cloud: no bulk download of map tiles and no exporting map content for use outside the service unless agreed in writing. Results from its Geocoding, Geolocation and Routing APIs may be used outside the service.
  • what3words: the API licence lets you keep three-word addresses without coordinates, with no limit. Coordinates converted from them may be kept only temporarily, 30 days at most, and must not be cached to avoid API requests.
  • TomTom: its Orbis map data can contain OpenStreetMap-derived data under the ODbL, and the ODbL obligations then apply to that part.
  • Plus Codes: none of this applies. The code is computed, not licensed, so you can keep it for as long as you keep the address.
OpenStreetMap

OpenStreetMap: free data, strict servers

OpenStreetMap data is open, but the servers the OpenStreetMap Foundation (OSMF) runs are shared by everyone and have rules. These apply in every country:

  • Licence: the data is under the Open Database License (ODbL). You may use and adapt it as long as you credit OpenStreetMap and its contributors, and data you change or build on may only be distributed under the same licence.
  • Credit on the map: the OSMF attribution guideline puts the credit in a corner of an interactive map. It may collapse after five seconds or when the user touches the map, provided the licence stays easy to find, for example behind an (i) button. "© OpenStreetMap contributors" is still acceptable.
  • Map tiles from tile.openstreetmap.org: best effort, no service level, and access can be blocked without notice. Send a User-Agent that names your app (library defaults such as okhttp or python-requests are blocked), cache tiles for at least 7 days, and do not bulk-download, prefetch or offer "download for offline". Commercial services are warned that access may be withdrawn at any point.
  • Search on the public Nominatim server: an absolute maximum of 1 request per second, counted across all your users together, no autocomplete while people type, no grid or systematic reverse lookups, and an identifying User-Agent or Referer. Your app must be able to switch to another service without an app update. Long-running bulk scripts are held to 4 requests per minute.
  • Tracking apps must host their own. The Nominatim policy names package and vehicle tracking among the uses that must run their own instance, which covers ride-hailing and delivery apps.
  • A source for self-hosting: Geofabrik publishes a Syria extract every day. On 16 November 2026 the file was 78 MB with data up to the previous evening, and it also comes as shapefile and GeoPackage. It can feed your own tile server, your own Nominatim and offline maps.

what3words or Plus Codes?

what3words gives every 3 metre square in the world a three-word name, and its about page names no country it leaves out. Using it in an app means using its licensed API. Business sign-ups go through automated checks that include sanctions-list searches. Its terms and API licence bar use by anyone located in a country under a US trade embargo or designated by the US as supporting terrorism, or listed on EU, UN or US restricted-party lists, and neither document names a country. Coordinates converted from three-word addresses may be stored for 30 days at most.

Plus Codes need none of that. The algorithm is open, the code is computed on the device, and you can keep it with the order forever. Ten characters are harder to remember than three words, so design the flow for sharing with a button rather than typing. For an app that has to work in Syria, not depending on an account or a network is the practical difference.

GPS

Do not trust a single GPS fix

Aviation authorities document satellite-navigation interference in the region. Their data comes from aircraft, not phones on the ground, and we found no official ground-level measurement for Syria. It is still enough reason to design the pin step carefully.

  • EASA's Safety Information Bulletin 2022-02R4, issued on 3 July 2026, says GNSS jamming and spoofing have grown in severity and sophistication, and names the south and eastern Mediterranean and the Middle East among the areas particularly affected.
  • EASA's table of impacted flight information regions on 14 October 2026 lists FIR Damascus, with possible spoofing flagged. The table is built from aircraft position broadcasts, so it says nothing direct about phones in Syrian streets.
  • An FAA advisory from April 2018, still posted, tells US operators to take care within 200 nautical miles of the Damascus FIR because of possible GPS interference.
  • What to build: draw the accuracy circle around the pin, and ask the user to confirm or drag it before you save.
  • Treat a position that jumps further than a car could travel since the last fix as suspect. EASA itself uses speed anomalies to flag possible spoofing.
  • Keep the landmark text even when the pin looks right, and let drivers and couriers report a wrong pin from their own app.
Checklist

Shipping addresses and maps for Syria

  1. Remove the required postcode

    Turn off postcode validation for Syrian addresses, including any that a checkout library or form builder adds for you. Keep the field optional only if you also ship abroad.

  2. Order the form the way an address is read

    City and area from pick lists, then street or landmark, then building, floor and apartment, then the phone number. Arabic first, English accepted. For marketplace listings the area is often enough, so keep exact pins for deliveries; see building a marketplace.

  3. Make the pin the user's job, and an easy one

    Open the map on the current position, let the user drag the pin, show the accuracy and ask for a confirmation. Save the coordinates, the Plus Code and how the pin was set.

  4. Choose the map vendor after reading its terms

    Check the sanctions or export clause, the storage rules for geocoding results, and the attribution rules. Write down the date of the version you read, and read it again before each major release.

  5. Host OpenStreetMap services yourself if you track vehicles

    The Nominatim policy says package and vehicle tracking apps must run their own instance, and ride-hailing and delivery apps are exactly that. Build tiles and search from the daily Syria extract and run them where your other servers live.

  6. Plan for no signal

    Compute Plus Codes on the phone, keep map data for the user's area on the device from your own tile server rather than tile.openstreetmap.org, which does not allow offline use, and let an address be saved offline and synced later, as in our offline-first guide.

  7. Verify the phone number

    When the pin is not enough, the number is how the courier finds the door. Normalise it to +963 format and verify it; see SMS codes for Syrian numbers.

FAQ

Common questions

Postal codes are not required in Syria: the Universal Postal Union lists it among the countries that do not require them. UPU's Syria sheet from September 2004 said a postcode system was being developed, and we found no newer official document. Make the field optional or hide it.

Sources

Where these facts come from

  1. General addressing issues FAQ (countries that do not require postal codes)Universal Postal Union · table dated Sep 2025
  2. Postal addressing systems: Syrian Arab Rep.Universal Postal Union · Sep 2004
  3. Addressing solutions (about 130 countries use postcodes)Universal Postal Union · accessed 16 Nov 2026
  4. International Mail Manual update for Syria (addressee mobile number and email)USPS Postal Bulletin · effective 1 Oct 2026
  5. Google Maps Platform prohibited territoriesGoogle · accessed 15 Nov 2026
  6. Mapbox Product Terms (export control; geocode storage, section 2.7)Mapbox · 20 Oct 2026
  7. Form of Mapbox Master Services Agreement v8.3.5Mapbox · 12 Sep 2025
  8. HERE Platform Terms (section 19, export control and sanctions)HERE Technologies · effective 18 Sep 2023
  9. MapTiler Cloud termsMapTiler · accessed 16 Nov 2026
  10. MapTiler general terms (MapTiler Satellite condition)MapTiler · accessed 16 Nov 2026
  11. TomTom developer portal terms and conditionsTomTom · accessed 16 Nov 2026
  12. Esri export compliance (prohibited countries and destinations)Esri · updated 30 Dec 2025
  13. iOS and iPadOS 27 feature availabilityApple · accessed 16 Nov 2026
  14. OpenStreetMap copyright and licence (ODbL)OpenStreetMap Foundation · accessed 16 Nov 2026
  15. Attribution GuidelinesOpenStreetMap Foundation · edited 10 Sep 2026
  16. Tile Usage PolicyOSMF Operations Working Group · accessed 16 Nov 2026
  17. Nominatim Usage PolicyOSMF Operations Working Group · accessed 16 Nov 2026
  18. OSMF Terms of UseOpenStreetMap Foundation · edited 31 Oct 2018
  19. Syria OpenStreetMap extract, updated dailyGeofabrik · accessed 16 Nov 2026
  20. Open Location Code (Plus Codes): README and Apache 2.0 licenceOpen Location Code project, GitHub · accessed 16 Nov 2026
  21. Open Location Code specification (code length and precision)Open Location Code project, GitHub · changed 10 Jan 2025
  22. About what3wordswhat3words · accessed 16 Nov 2026
  23. what3words Terms and Conditions (clause 7.3)what3words · 20 Apr 2026
  24. what3words API Licence Agreementwhat3words · 26 Oct 2026
  25. Safety Information Bulletin 2022-02R4 on GNSS outages and alterationsEASA · 3 Jul 2026
  26. GNSS outages and alterations: impacted flight information regionsEASA · table of 14 Oct 2026
  27. Advisory NOTAM KICZ A0009/18 (Damascus FIR)US Federal Aviation Administration · 14 Apr 2018

Checked 16 November 2026 on each publisher's own page (Google Maps Platform on 15 November 2026). Vendor terms change, and some clauses depend on US designations on the day you use a service, which this page does not assess. Confirm with the vendor before you build on it. Nothing here is legal advice.

Building an app with addresses and maps for Syria?

Tell us what your app needs from the map: deliveries, rides, or just a shop location. We will help you design the address flow and pick a map setup whose terms you have read.