Tips for accurate addresses
Address geocoding is not perfect. These tips explain why some addresses fail to validate in Mappy and how to format them for the best results.
Green — address validated
The address was found with high confidence by at least one geocoding provider. A pin is placed on the map at the correct location. These addresses are ready to include in your route.
Yellow — needs review
The address was found, but with lower confidence — for example, it matched a street without a specific house number, or matched a city-level location rather than a specific building. Click the warning indicator to see the matched location on the map and verify it is correct before including it in your route.
Red — address not found or incomplete
No geocoding provider could locate this address, or Mappy detected that it is too incomplete to validate safely. This can mean a typo, a missing city, a house number without a street, or noisy text copied from a CRM/CSV export. Click the red indicator to open the inline editor and correct the address.
Include street name, number, and city
The most reliable format: "Street Name Number, City". Examples: "Ferhadija 1, Sarajevo" · "Unter den Linden 1, Berlin" · "Mariahilfer Straße 1, Wien". Adding a postal code further improves accuracy: "Ferhadija 1, 71000 Sarajevo".
Use the local spelling of the address
Geocoders generally perform better with the official local spelling. In Bosnia & Herzegovina: use đ, š, č, ć, ž correctly. "Džemala Bijedića" geocodes better than "Dzemala Bijedica". In Germany: Straße, not Strasse (though both usually work).
For short addresses without city, add the country
If your address list contains only street and number without the city (e.g. "Ferhadija 1"), Mappy uses your detected country code (from your IP) to improve accuracy automatically. But if geocoding still fails, manually add the city: "Ferhadija 1, Sarajevo".
For businesses and landmarks, include the address too
POI names like "Bosmal City Center" or "UKC" may not geocode reliably without a street address. Include both: "Bosmal City Center, Milana Preloga 12a, Sarajevo" for best results.
Confirm extracted addresses from long text
If you paste a long CRM note or CSV row, Mappy may extract a likely address candidate first. Review the extracted address before validation so a customer note, category or branch description is not accidentally treated as the delivery location.
Avoid ZIP/postal code only
A postal code alone (e.g. "71000") geocodes to the centre of the postal area, not a specific address. Always include at least a street name.
Avoid number + city only
Inputs like "77, Erpe" or "402, bus2, Mere" are usually not complete addresses. Add the street name, house number and city before validation.
Avoid vague intersections without a number
"Corner of Ferhadija and Titova" is too ambiguous for reliable geocoding. Use one of the specific street names with a house number instead.
| ✗ Bad | ✓ Better | Why |
|---|---|---|
| Ferhadija 1 | Ferhadija 1, Sarajevo | Add city name |
| Hauptstr. | Hauptstraße 12, München | Add number and city; avoid abbreviations |
| Near the mosque | Semira Frašte bb, Sarajevo | Use the street address, not a description |
| 71000 | Maršala Tita 54, Sarajevo 71000 | Postal code alone is insufficient |
| Bingo | Bingo, Zmaja od Bosne 60, Sarajevo | Include street for POIs |
An address that exists is showing as red. What should I do?
Try adding the city name, the country, or the postal code. If the street name has special characters (š, đ, č, ć, ž), make sure they are correctly typed. Click the red indicator to edit and retry.
The pin is placed slightly wrong on the map. Can I fix it?
Yes. Open the address editor, make the address more specific or replace it with the expected address, and save to revalidate. A green status means the address was found, but you should still review the pin if the location matters.
Why does Mappy ask me to save a Google-sourced alias?
When an address can only be validated through Google, Mappy may ask you to save a local alias in your browser. This is optional and helps future validations try other providers first instead of using Google again for the same address.
What does "bb" mean in Bosnian addresses?
"bb" stands for "bez broja" (without number) — it's used for buildings or entrances that don't have an official house number. Addresses with bb may geocode to an approximate location on the street rather than a specific point.
My address is in a newly built area and can't be found. What do I do?
New addresses are sometimes not yet in geocoding databases. Options: use a nearby address and note the actual delivery address; or use Google Maps to find the coordinates of the location and add the address manually with a note.