#ifndef __MAPCODER_H__

#define __MAPCODER_H__

#ifdef __cplusplus

extern "C" {

#include "mapcode_territories.h"

#ifndef NO_SUPPORT_ALPHABETS

#include "mapcode_alphabets.h"

#define MAPCODE_C_VERSION "2.4.1"

#define UWORD unsigned short int // 2-byte unsigned integer.

#define MAX_NR_OF_MAPCODE_RESULTS 22 // Max. number of results ever returned by encoder (e.g. for 26.904899, 95.138515).

#define MAX_PROPER_MAPCODE_LEN 11 // Max. number of characters in a proper mapcode (including the dot, excl. precision extension).

#define MAX_PRECISION_DIGITS 8 // Max. number of extension characters (excluding the hyphen). Must be even.

#define MAX_ISOCODE_LEN 7 // Max. number of characters of a valid ISO3166 territory code; although nothing longer than SIX characters is ever generated (RU-KAM), users can input SEVEN characters (RUS-KAM).

#define MAX_TERRITORY_FULLNAME_LEN 79 // Max. number of characters to store the longest possible territory name (in any alphabet, excl. 0-terminator).

#define MAX_CLEAN_MAPCODE_LEN (MAX_PROPER_MAPCODE_LEN + 1 + MAX_PRECISION_DIGITS) // Max. number of characters in a clean mapcode (excluding zero-terminator).

#define MAX_MAPCODE_RESULT_LEN (MAX_ISOCODE_LEN + 1 + MAX_CLEAN_MAPCODE_LEN + 1) // Max. number of characters to store a single result (including zero-terminator).

typedef struct {

int count; // The number of mapcode results (length of array).

char mapcode[MAX_NR_OF_MAPCODE_RESULTS][MAX_MAPCODE_RESULT_LEN]; // The mapcodes.

} Mapcodes;

typedef struct {

char territoryISO[MAX_ISOCODE_LEN + 1]; // The (trimmed and uppercased) candidate territory ISO3166 code.

enum Territory territoryCode; // The territory, as recognized and disambiguated from territoryISO.

char properMapcode[MAX_PROPER_MAPCODE_LEN +

1]; // The (trimmed and uppercased) candidate proper mapcode (ex territory or extension).

int indexOfDot; // Position of dot in properMapcode (a value between 2 and 5).

char precisionExtension[MAX_PRECISION_DIGITS + 1]; // The (trimmed and uppercased) candidate ex excluding hyphen.

} MapcodeElements;

enum MapcodeError {

};

int encodeLatLonToMapcodes(

int extraDigits);

int encodeLatLonToSingleMapcode(

int extraDigits);

enum MapcodeError decodeMapcodeToLatLon(

enum Territory territory);

enum MapcodeError compareWithMapcodeFormat(

const char *asciiString,

int stringIncludesTerritory);

enum MapcodeError parseMapcodeString(

enum Territory territory);

enum Territory getTerritoryCode(

const char *territoryISO,

enum Territory optionalTerritoryContext);

char *getTerritoryIsoName(

char *territoryISO,

enum Territory territory,

int useShortName);

enum Territory getCountryOrParentCountry(enum Territory territory);

enum Territory getParentCountryOf(enum Territory territory);

double distanceInMeters(double latDeg1, double lonDeg1, double latDeg2, double lonDeg2);

double maxErrorInMeters(int extraDigits);

int multipleBordersNearby(

double latDeg,

double lonDeg,

enum Territory territory);

int getFullTerritoryNameEnglish(char *territoryName, enum Territory territory, int alternative);

#ifndef NO_SUPPORT_ALPHABETS

int getFullTerritoryNameLocalInAlphabet(char *territoryName, enum Territory territory, int alternative, enum Alphabet alphabet);

int getFullTerritoryNameLocal(char *territoryName, enum Territory territory, int alternative);

#define MAX_ALPHABETS_PER_TERRITORY 3

typedef struct {

int count;

enum Alphabet alphabet[MAX_ALPHABETS_PER_TERRITORY];

} TerritoryAlphabets;

const TerritoryAlphabets *getAlphabetsForTerritory(enum Territory territory);

char *convertToRoman(char *asciiString, int maxLength, const UWORD *utf16String);

UWORD *convertToAlphabet(UWORD *utf16String, int maxLength, const char *asciiString, enum Alphabet alphabet);

void convertUtf16ToUtf8(char *utf8String, const UWORD *utf16String);

int convertUtf8ToUtf16(UWORD *utf16, const char *utf8);

enum Alphabet recognizeAlphabetUtf16(const UWORD *utf16String);

enum Alphabet recognizeAlphabetUtf8(const char *utf8);

#endif // NO_SUPPORT_ALPHABETS

#ifdef __cplusplus

}