w3w java wrapper

w3w-java-wrapper

Une bibliothèque Java pour utiliser l'API What3words V3.

Les méthodes API sont regroupées en un seul objet de service qui peut être géré de manière centralisée par une instance what3wordsv3. Il agira comme une usine pour tous les points de terminaison de l'API et les initialisera automatiquement avec votre clé API.

Pour obtenir une clé API, veuillez visiter https://what3words.com/select-plan et inscrivez-vous à un compte.

Installation

L'artefact est disponible via Maven Central.

Maven

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

Grade

implémentation 'com.what3words: w3w-java-wrapper: 3.1.19'

Documentation

Voir la documentation API publique What3Words

Utilisation générale

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

    }
}

Méthodes API

• Convertir en adresse de 3 mots - convertir une latitude et une longitude en une adresse de 3 mots
• Convertir en coordonnées - Convertir une adresse de 3 mots en une latitude et une longitude
• AutoSuggest - Autosuggest peut prendre une adresse de 3 mots légèrement incorrecte et suggérer une liste d'adresses valides de 3 mots.
• Section de la grille - Renvoie une section de la grille de 3M x 3M What3words pour une boîte de délimitation.
• Langues disponibles - Récupère une liste toutes les langues d'adresse mot de 3 mots disponibles.
• Est valide à 3 adresses Word - vérifie si une adresse What3words est valide.

Fonctions d'assistance

ISPOSSIBLE3WA

Vérifiez si une chaîne est une adresse What3words possible. Un rappel que cela vérifie simplement le format du texte, d'où pourquoi est appelé possible3wa, pour vérifier s'il s'agit d'une véritable adresse What3words s'il vous plaît utilise est une adresse de 3 mots valide.

 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

Vérifiez si une chaîne est une adresse What3Words possible, ce regex permet différents séparateurs (c'est-à-dire: n'utilisant pas standard stop / point standard). Un rappel que cela vérifie simplement le format du texte, d'où pourquoi est appelé didyoumean3wa, pour vérifier s'il s'agit d'une véritable adresse What3Words s'il vous plaît utiliser est une adresse de 3 mots valide en utilisant Full Stop comme séparateur.

 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

findSible3wa

Obtenez toutes les adresses What3Words possibles à partir d'un texte. Retournera une liste vide si aucune adresse possible n'est trouvée. Rappelez-vous que cela vérifie simplement le format du texte, d'où pourquoi s'appelle FindSposible3wa, pour vérifier s'il s'agit d'une véritable adresse What3Words s'il vous plaît utilise est une adresse Word valide pour vérifier chaque élément de la liste.

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