w3w java wrapper

W3W-Java-Wrapper

Библиотека Java для использования API What3Word V3.

Методы API сгруппированы в единый объект сервиса, который может управляться централизованным экземпляром What3WordSV3. Он будет выступать в качестве фабрики для всех конечных точек API и автоматически инициализация их с вашим ключом API.

Чтобы получить ключ API, пожалуйста, посетите https://what3words.com/select-plan и зарегистрируйтесь на учетную запись.

Установка

Артефакт доступен через Maven Central.

Мавен

< dependency >
  < groupId >com.what3words</ groupId >
  < artifactId >w3w-java-wrapper</ artifactId >
  < version >3.1.19</ version >
</ dependency >

Градл

Реализация 'com.what3words: W3W-java-wrapper: 3.1.19'

Документация

Смотрите документацию What3Words Public API

Общее использование

 // For all requests a what3words API key is needed
What3WordsV3 api = new What3WordsV3 ( "what3words-api-key" );

// In the case that you run our Enterprise Suite API Server yourself, you may specify the URL to your own server like so:
//What3WordsV3 api = new What3WordsV3("what3words-api-key", "https://api.yourserver.com/v3/");

/**
 * Additionally, if you run the Enterprise Suite API Server there is another optional setup() parameter: customHeaders. 
 * Use this if you need to send custom headers to your own server:
 */
//Map<String, String> headers = new HashMap<String, String>();
//headers.put("Name1", "Value1");
//headers.put("Name2", "Value2");
//What3WordsV3 api = new What3WordsV3("what3words-api-key", "https://api.yourserver.com/v3/", headers);

// Create and execute a request with the 3 word address such as "filled.count.soap"
ConvertToCoordinates coordinates = api . convertToCoordinates ( "filled.count.soap" ). execute ();

if ( coordinates . isSuccessful ()) { // the request was successful
    System . out . println ( "Coordinates: " + coordinates );

} else { // the request was not successful
    What3WordsError error = coordinates . getError ();

    if ( error == What3WordsError . BAD_WORDS ) { // The three word address provided is invalid
        System . out . println ( "BadWords: " + error . getMessage ());

    } else if ( error == What3WordsError . INTERNAL_SERVER_ERROR ) { // Server Error
        System . out . println ( "InternalServerError: " + error . getMessage ());

    } else if ( error == What3WordsError . NETWORK_ERROR ) { // Network Error
        System . out . println ( "NetworkError: " + error . getMessage ());

    } else { // Unknown Error
        System . out . println ( error + ": " + error . getMessage ());

    }
}

Методы API

• Преобразовать в 3 слова - преобразовать широту и долготу в адрес 3 слова
• Преобразовать в координаты - преобразовать адрес 3 слова в широту и долготу
• Autosuggest - Autosuggest может взять немного неверный адрес 3 слова и предложить список действительных 3 слов.
• Секция сети - возвращает раздел 3M x 3M сетки What3words для ограничивающей коробки.
• Доступные языки - получает список, все доступны 3 языка адреса.
• Действителен 3 Адресу - проверяет, является ли адрес what3words действителен.

Вспомогательные функции

Ispossible3wa

Проверьте, является ли строка возможным адресом What3words. Напоминание о том, что это просто проверяет формат текста, следовательно, почему называется возможным 3WA, чтобы проверить, является ли это реальным адресом What3words, пожалуйста, используйте, является действительным 3 слов.

 Boolean isPossible = What3WordsV3 . isPossible3wa ( "filled.count.soap" ); // returns true
Boolean isPossible = What3WordsV3 . isPossible3wa ( "not a 3wa" ); // returns false
Boolean isPossible = What3WordsV3 . isPossible3wa ( "not.3wa address" ); //returns false

Didyoumean3wa

Проверьте, является ли строка возможным адресом What3words, эта режима позволяет различные разделители (т.е. не использовать стандартную полную остановку/точку). Напоминание о том, что это просто проверяет формат текста, поэтому называется Didyoumean3wa, чтобы проверить, является ли это реальным адресом What3words, используйте, действителен 3 слов, используя полную остановку в качестве разделителя.

 Boolean isDym = What3WordsV3 . didYouMean3wa ( "filled-count-soap" ); // returns true
Boolean isDym = What3WordsV3 . didYouMean3wa ( "not valid" ); // returns false
Boolean isDym = What3WordsV3 . didYouMean3wa ( "not.3wa address" ); // returns false
Boolean isDym = What3WordsV3 . didYouMean3wa ( "not.threewa address" ); // returns true

findpossible3wa

Получите любые возможные адреса What3words из текста. Вернут пустой список, если не найдено возможных адресов. Напоминание о том, что это просто проверяет формат текста, следовательно, почему называется findpossible3wa, чтобы проверить, является ли это реальным адресом What3words, пожалуйста, используйте, действителен 3 слова для проверки каждого элемента списка.

 List < String > possible = What3WordsV3 . findPossible3wa ( "Please leave by my porch at filled.count.soap" ); //returns ["filled.count.soap"]
List < String > possible = What3WordsV3 . findPossible3wa ( "Please leave by my porch at filled.count.soap or deed.tulip.judge" ); // returns ["filled.count.soap", "deed.tulip.judge"]
List < String > possible = What3WordsV3 . findPossible3wa ( "Please leave by my porch at" ); // returns []