Код страны для международных вод
Я реализую API и C++ SDK, которые будут возвращать двухбуквенные коды стран, такие как "США" для данной широты / долготы. Эти ISO 3166-1 alpha-2 хорошо документированы, но код для международных вод отсутствует. Существует ли соглашение о том, что должно быть возвращено в этом случае?
2 ответа
Раздел "Назначенный пользователем элемент кода" статьи Wikipedia ISO 3166-1 alpha-2 может быть полезен. В частности:
ЛОКОД ООН назначает XZ для представления установок в международных водах.
Это не часть ISO 3166, но, по крайней мере, есть пример того, как другая реализация справилась с этим.
Ваш API мог бы вернуть 404 не найден или пустую строку для такого местоположения, таким образом, было бы ясно, что для данного местоположения невозможно получить код страны. Кажется, что нет реального соглашения для присвоения какого-либо кода международным водам.
В случае API C++ рассмотрите возможность добавления какого-либо статуса к возвращаемому значению, чтобы указать, был ли поиск успешным.
Ошибка всегда должна быть опцией в любом дизайне API!