w3w java wrapper

W3W-Java-wrapper

Perpustakaan Java untuk menggunakan API What3Words V3.

Metode API dikelompokkan menjadi satu objek layanan tunggal yang dapat dikelola secara terpusat oleh instance What3WordSV3. Ini akan bertindak sebagai pabrik untuk semua titik akhir API dan secara otomatis akan menginisialisasi mereka dengan kunci API Anda.

Untuk mendapatkan kunci API, silakan kunjungi https://what3words.com/select-plan dan daftar untuk akun.

Instalasi

Artefak tersedia melalui Maven Central.

Maven

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

Lulusan

Implementasi 'com.what3words: w3w-java-wrapper: 3.1.19'

Dokumentasi

Lihat dokumentasi API publik What3Words

Penggunaan Umum

 // 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 ());

    }
}

Metode API

• Konversi ke 3 Alamat Kata - Konversi garis lintang dan bujur menjadi alamat 3 kata
• Konversi ke Koordinat - Konversi alamat 3 kata ke garis lintang dan bujur
• AutoSuggest - AutoSuggest dapat mengambil alamat 3 kata yang sedikit salah, dan menyarankan daftar alamat 3 kata yang valid.
• Bagian Grid - Mengembalikan bagian dari kisi 3m x 3m What3words untuk kotak pembatas.
• Bahasa yang Tersedia - Mengambil Daftar Semua Bahasa Alamat 3 yang Tersedia.
• Valid 3 alamat kata - memeriksa apakah alamat what3words valid.

Fungsi pembantu

ISPOSSIBLE3WA

Periksa apakah string adalah alamat What3Words yang mungkin. Pengingat bahwa ini hanya memeriksa format teks, karenanya mengapa disebut mungkin3WA, untuk memverifikasi apakah itu alamat What3Words yang nyata, harap gunakan adalah alamat 3 kata yang valid.

 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

Periksa apakah string adalah alamat What3Words yang mungkin, regex ini memungkinkan pemisah yang berbeda (yaitu: tidak menggunakan stop/dot penuh standar). Pengingat bahwa ini hanya memeriksa format teks, karenanya mengapa disebut didyoumean3wa, untuk memverifikasi apakah itu alamat what3words yang nyata, silakan gunakan adalah alamat 3 kata yang valid menggunakan stop penuh sebagai pemisah.

 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

Dapatkan apa pun yang memungkinkan alamat what3words dari sebuah teks. Akan mengembalikan daftar kosong jika tidak ada alamat yang ditemukan. Pengingat bahwa ini hanya memeriksa format teks, karenanya mengapa disebut findPossible3wa, untuk memverifikasi apakah itu alamat what3words yang nyata, silakan gunakan adalah alamat 3 kata yang valid untuk memverifikasi setiap item dari daftar.

 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 []