w3w java wrapper

w3w-java-wrapper

Java庫使用What3Words V3 API。

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 >

gradle

實現'com.what3words：w3w-java-wrapper：3.1.19'

文件

請參閱What What 3words公共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，以驗證它是否是真實的What 3words地址，請使用有效的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

didyyoumean3wa

檢查字符串是否可能是一個可能的What3Words地址，此正則允許不同的分隔符（即：不使用標準的全停止/點）。提醒您，這只需檢查文本的格式，因此為什麼稱為DIDYOUMEAN3WA，以驗證是否是真實的What 3words地址，請使用使用Full Stop作為分隔器有效的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

從文本中獲取任何可能的3words地址。如果找不到可能的地址，將返回空列表。提醒您這只需檢查文本的格式，因此為什麼稱為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 []