From: marc tobias <mtmail@gmx.net>
Date: Tue, 21 Apr 2020 15:42:12 +0000 (+0200)
Subject: API documentation: clarification countrycode assignment happens using admin_level... 
X-Git-Tag: v3.5.0~33^2
X-Git-Url: https://git.openstreetmap.org./nominatim.git/commitdiff_plain/e33315eaa66d4e7612676a8e5cfdd249809670ad

API documentation: clarification countrycode assignment happens using admin_level=2 tags
---

diff --git a/docs/api/Search.md b/docs/api/Search.md
index 688d7e0c..c18655dc 100644
--- a/docs/api/Search.md
+++ b/docs/api/Search.md
@@ -92,8 +92,12 @@ comma-separated list of language codes.
 * `countrycodes=<countrycode>[,<countrycode>][,<countrycode>]...`
 
 Limit search results to one or more countries. `<countrycode>` must be the
-ISO 3166-1alpha2 code, e.g. `gb` for the United Kingdom, `de` for Germany.
+[ISO 3166-1alpha2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code,
+e.g. `gb` for the United Kingdom, `de` for Germany.
 
+Each place in Nominatim is assigned to one country code based
+on `admin_level=2` tags, in rare cases to none (for example in
+international waters outside any country).
 
 * `exclude_place_ids=<place_id,[place_id],[place_id]`