Place Autocomplete

Le service de saisie semi-automatique du SDK Places pour Android renvoie des prédictions de lieu en réponse aux requêtes de recherche des utilisateurs. À mesure que l'utilisateur saisit du texte, le service de saisie semi-automatique renvoie des suggestions de lieux tels que des établissements, des adresses, des plus codes et des points d'intérêt.

Vous pouvez ajouter Autocomplete à votre application de plusieurs façons :

• Ajoutez un widget de saisie semi-automatique pour gagner du temps de développement et garantir une expérience utilisateur cohérente.
• Obtenez des prédictions de lieu de manière programmatique pour créer une expérience utilisateur personnalisée.

Ajouter un widget de saisie semi-automatique

Le widget de saisie semi-automatique est une boîte de dialogue de recherche dotée d'une fonctionnalité de saisie semi-automatique intégrée. Lorsque l'utilisateur saisit des termes de recherche, le widget affiche une liste de lieux susceptibles d'être sélectionnés. Lorsque l'utilisateur effectue une sélection, une instance Place est renvoyée, que votre application peut ensuite utiliser pour obtenir des informations sur le lieu sélectionné.

Deux options sont possibles pour ajouter un widget Autocomplete à votre application :

• Option 1: intégrer un AutocompleteSupportFragment.
• Option 2: Utiliser un intent pour lancer l'activité de saisie semi-automatique.

Option 1: Intégrer un AutocompleteSupportFragment

Pour ajouter un AutocompleteSupportFragment à votre application, procédez comme suit:

1. Ajoutez un fragment à la mise en page XML de votre activité.
2. Ajoutez un écouteur à votre activité ou fragment.

Ajouter AutocompleteSupportFragment à une activité

Pour ajouter AutocompleteSupportFragment à une activité, ajoutez un nouveau fragment à une mise en page XML. Exemple :

<fragment android:id="@+id/autocomplete_fragment"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:name="com.google.android.libraries.places.widget.AutocompleteSupportFragment"
  />

• Par défaut, le fragment ne contient ni bordure, ni arrière-plan. Pour fournir une apparence visuelle cohérente, imbriquez le fragment dans un autre élément de mise en page, tel que CardView.
• Si vous utilisez le fragment Autocomplete et que vous devez remplacer onActivityResult, vous devez appeler super.onActivityResult, sinon le fragment ne fonctionnera pas correctement.

Ajouter un écouteur PlaceSelectionListener à une activité

PlaceSelectionListener gère le renvoi d'un lieu en réponse à la sélection de l'utilisateur. Le code suivant montre comment créer une référence au fragment et ajouter un écouteur à votre AutocompleteSupportFragment:

    // Initialize the AutocompleteSupportFragment.
    val autocompleteFragment =
        supportFragmentManager.findFragmentById(R.id.autocomplete_fragment)
                as AutocompleteSupportFragment

    // Specify the types of place data to return.
    autocompleteFragment.setPlaceFields(listOf(Place.Field.ID, Place.Field.NAME))

    // Set up a PlaceSelectionListener to handle the response.
    autocompleteFragment.setOnPlaceSelectedListener(object : PlaceSelectionListener {
        override fun onPlaceSelected(place: Place) {
            // TODO: Get info about the selected place.
            Log.i(TAG, "Place: ${place.name}, ${place.id}")
        }

        override fun onError(status: Status) {
            // TODO: Handle the error.
            Log.i(TAG, "An error occurred: $status")
        }
    })

      

    // Initialize the AutocompleteSupportFragment.
    AutocompleteSupportFragment autocompleteFragment = (AutocompleteSupportFragment)
            getSupportFragmentManager().findFragmentById(R.id.autocomplete_fragment);

    // Specify the types of place data to return.
    autocompleteFragment.setPlaceFields(Arrays.asList(Place.Field.ID, Place.Field.NAME));

    // Set up a PlaceSelectionListener to handle the response.
    autocompleteFragment.setOnPlaceSelectedListener(new PlaceSelectionListener() {
        @Override
        public void onPlaceSelected(@NonNull Place place) {
            // TODO: Get info about the selected place.
            Log.i(TAG, "Place: " + place.getName() + ", " + place.getId());
        }


        @Override
        public void onError(@NonNull Status status) {
            // TODO: Handle the error.
            Log.i(TAG, "An error occurred: " + status);
        }
    });

      

Option 2: Utiliser un intent pour lancer l'activité de saisie semi-automatique

Si vous souhaitez que votre application utilise un autre flux de navigation (par exemple, pour déclencher l'expérience de saisie semi-automatique à partir d'une icône plutôt que d'un champ de recherche), elle peut lancer la saisie semi-automatique à l'aide d'un intent.

Pour lancer le widget de saisie semi-automatique en utilisant un intent, procédez comme suit :

1. Utilisez Autocomplete.IntentBuilder pour créer un intent en transmettant le mode Autocomplete souhaité.
2. Définissez un lanceur de résultats d'activité registerForActivityResult permettant de lancer l'intent et de gérer la prédiction de lieu sélectionnée par l'utilisateur dans le résultat.

Créer un intent de saisie semi-automatique

L'exemple ci-dessous utilise Autocomplete.IntentBuilder pour créer un intent afin de lancer le widget de saisie semi-automatique en tant qu'intent:

    // Set the fields to specify which types of place data to
    // return after the user has made a selection.
    val fields = listOf(Place.Field.ID, Place.Field.NAME)

    // Start the autocomplete intent.
    val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
        .build(this)
    startAutocomplete.launch(intent)

      

    // Set the fields to specify which types of place data to
    // return after the user has made a selection.
    List<Place.Field> fields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

    // Start the autocomplete intent.
    Intent intent = new Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
            .build(this);
    startAutocomplete.launch(intent);

      

Lorsque vous utilisez un intent pour lancer le widget de saisie semi-automatique, vous pouvez choisir un mode d'affichage en superposition ou en plein écran. Les captures d'écran suivantes montrent chaque mode d'affichage respectivement:

Enregistrer un rappel pour le résultat de l'intent

Pour recevoir une notification lorsque l'utilisateur a sélectionné un lieu, définissez un lanceur d'applications registerForActivityResult(), qui lance l'activité et gère également le résultat, comme illustré dans l'exemple suivant. Si l'utilisateur a sélectionné une prédiction, celle-ci est diffusée dans l'intent contenu dans l'objet de résultat. Comme l'intent a été créé par Autocomplete.IntentBuilder, la méthode Autocomplete.getPlaceFromIntent() peut en extraire l'objet Place.

private val startAutocomplete =
    registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result: ActivityResult ->
        if (result.resultCode == Activity.RESULT_OK) {
            val intent = result.data
            if (intent != null) {
                val place = Autocomplete.getPlaceFromIntent(intent)
                Log.i(
                    TAG, "Place: ${place.name}, ${place.id}"
                )
            }
        } else if (result.resultCode == Activity.RESULT_CANCELED) {
            // The user canceled the operation.
            Log.i(TAG, "User canceled autocomplete")
        }
    }

      

private final ActivityResultLauncher<Intent> startAutocomplete = registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        result -> {
            if (result.getResultCode() == Activity.RESULT_OK) {
                Intent intent = result.getData();
                if (intent != null) {
                    Place place = Autocomplete.getPlaceFromIntent(intent);
                    Log.i(TAG, "Place: ${place.getName()}, ${place.getId()}");
                }
            } else if (result.getResultCode() == Activity.RESULT_CANCELED) {
                // The user canceled the operation.
                Log.i(TAG, "User canceled autocomplete");
            }
        });

      

Obtenir des prédictions de lieux de manière programmatique

Vous pouvez créer une UI de recherche personnalisée au lieu de l'UI fournie par le widget de saisie semi-automatique. Pour ce faire, votre application doit obtenir des prédictions de lieux de manière programmatique. Votre application peut obtenir une liste d'adresses et/ou de noms de lieux prédits à partir de l'API de saisie semi-automatique en appelant PlacesClient.findAutocompletePredictions(), en transmettant un objet FindAutocompletePredictionsRequest avec les paramètres suivants:

• Obligatoire:chaîne query contenant le texte saisi par l'utilisateur.
• Recommandé:Un AutocompleteSessionToken, qui regroupe les phases de requête et de sélection d'une recherche d'utilisateur dans une session distincte à des fins de facturation. La session commence lorsque l'utilisateur commence à saisir une requête et se termine lorsqu'il sélectionne un lieu.
• Recommandé:Un objet RectangularBounds, qui spécifie les limites de latitude et de longitude afin de contraindre les résultats à la région spécifiée.
• Facultatif:un ou plusieurs codes pays à deux lettres (ISO 3166-1 Alpha-2), indiquant le ou les pays auxquels les résultats doivent être limités.

• Facultatif:Un TypeFilter, que vous pouvez utiliser pour limiter les résultats au type de lieu spécifié. Les types de lieux suivants sont acceptés:

  • TypeFilter.GEOCODE : renvoie uniquement les résultats de geocoding et non les établissements. Utilisez cette requête pour affiner les résultats lorsque le lieu spécifié est indéterminé.
  • TypeFilter.ADDRESS : renvoie uniquement les résultats de saisie semi-automatique avec une adresse précise. Utilisez ce type lorsque vous savez que l'utilisateur recherche une adresse spécifiée complète.
  • TypeFilter.ESTABLISHMENT : renvoie uniquement les lieux qui sont des établissements.

  • TypeFilter.REGIONS : renvoie uniquement les lieux correspondant à l'un des types suivants :

  • LOCALITY

  • SUBLOCALITY

  • POSTAL_CODE

  • COUNTRY

  • ADMINISTRATIVE_AREA_LEVEL_1

  • ADMINISTRATIVE_AREA_LEVEL_2

  • TypeFilter.CITIES : renvoie uniquement les résultats correspondant à LOCALITY ou ADMINISTRATIVE_AREA_LEVEL_3.

• Facultatif:un LatLng spécifiant l'emplacement de départ de la requête. Lorsque vous appelez setOrigin(), le service renvoie la distance en mètres (distanceMeters) à partir de l'origine spécifiée, pour chaque prédiction de saisie semi-automatique de la réponse.

Pour en savoir plus sur les types de lieux, consultez le guide sur les types de lieux.

L'exemple ci-dessous montre un appel complet à PlacesClient.findAutocompletePredictions().

    // Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
    // and once again when the user makes a selection (for example when calling fetchPlace()).
    val token = AutocompleteSessionToken.newInstance()

    // Create a RectangularBounds object.
    val bounds = RectangularBounds.newInstance(
        LatLng(-33.880490, 151.184363),
        LatLng(-33.858754, 151.229596)
    )
    // Use the builder to create a FindAutocompletePredictionsRequest.
    val request =
        FindAutocompletePredictionsRequest.builder()
            // Call either setLocationBias() OR setLocationRestriction().
            .setLocationBias(bounds)
            //.setLocationRestriction(bounds)
            .setOrigin(LatLng(-33.8749937, 151.2041382))
            .setCountries("AU", "NZ")
            .setTypesFilter(listOf(PlaceTypes.ADDRESS))
            .setSessionToken(token)
            .setQuery(query)
            .build()
    placesClient.findAutocompletePredictions(request)
        .addOnSuccessListener { response: FindAutocompletePredictionsResponse ->
            for (prediction in response.autocompletePredictions) {
                Log.i(TAG, prediction.placeId)
                Log.i(TAG, prediction.getPrimaryText(null).toString())
            }
        }.addOnFailureListener { exception: Exception? ->
            if (exception is ApiException) {
                Log.e(TAG, "Place not found: ${exception.statusCode}")
            }
        }

      

    // Create a new token for the autocomplete session. Pass this to FindAutocompletePredictionsRequest,
    // and once again when the user makes a selection (for example when calling fetchPlace()).
    AutocompleteSessionToken token = AutocompleteSessionToken.newInstance();

    // Create a RectangularBounds object.
    RectangularBounds bounds = RectangularBounds.newInstance(
            new LatLng(-33.880490, 151.184363),
            new LatLng(-33.858754, 151.229596));
    // Use the builder to create a FindAutocompletePredictionsRequest.
    FindAutocompletePredictionsRequest request = FindAutocompletePredictionsRequest.builder()
            // Call either setLocationBias() OR setLocationRestriction().
            .setLocationBias(bounds)
            //.setLocationRestriction(bounds)
            .setOrigin(new LatLng(-33.8749937, 151.2041382))
            .setCountries("AU", "NZ")
            .setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS))
            .setSessionToken(token)
            .setQuery(query)
            .build();

    placesClient.findAutocompletePredictions(request).addOnSuccessListener((response) -> {
        for (AutocompletePrediction prediction : response.getAutocompletePredictions()) {
            Log.i(TAG, prediction.getPlaceId());
            Log.i(TAG, prediction.getPrimaryText(null).toString());
        }
    }).addOnFailureListener((exception) -> {
        if (exception instanceof ApiException) {
            ApiException apiException = (ApiException) exception;
            Log.e(TAG, "Place not found: " + apiException.getStatusCode());
        }
    });

      

L'API renvoie un FindAutocompletePredictionsResponse dans un Task. Le FindAutocompletePredictionsResponse contient une liste d'objets AutocompletePrediction représentant les lieux prédits. Cette liste peut être vide si aucun lieu connu ne correspond à la requête et aux critères de filtre.

Pour chaque lieu proposé, vous pouvez appeler les méthodes suivantes pour récupérer des détails sur le lieu:

• getFullText(CharacterStyle) affiche le texte complet de la description d'un lieu. Il s'agit d'une combinaison du texte principal et du texte secondaire. Exemple: "Tour Eiffel, Avenue Anatole France, Paris, France". En outre, cette méthode vous permet de mettre en surbrillance les sections de la description qui correspondent à la recherche avec le style de votre choix à l'aide de CharacterStyle. Le paramètre CharacterStyle est facultatif. Définissez-la sur null si vous n'avez pas besoin de mise en surbrillance.
• getPrimaryText(CharacterStyle) affiche le texte principal décrivant un lieu. Il s'agit généralement du nom du lieu. Exemples: "Tour Eiffel" et "123 Pitt Street".
• getSecondaryText(CharacterStyle) affiche le texte secondaire de la description d'un lieu. Cela peut être utile, par exemple, comme deuxième ligne pour afficher des prédictions de saisie semi-automatique. Exemples : "Avenue Anatole France, Paris, France" et "Sydney, Nouvelle-Galles du Sud".
• getPlaceId() renvoie l'ID de lieu du lieu prédit. Un ID de lieu est un identifiant textuel qui identifie un lieu de manière unique. Vous pouvez l'utiliser pour récupérer l'objet Place ultérieurement. Pour en savoir plus sur les ID de lieu dans le SDK Places pour Android, consultez Place Details. Pour obtenir des informations générales sur les ID de lieu, consultez la présentation des ID de lieu.
• getPlaceTypes() affiche la liste des types de lieux associés à ce lieu.
• getDistanceMeters() affiche la distance en ligne droite en mètres entre ce lieu et le point de départ spécifié dans la requête.

Jetons de session

Les jetons de session regroupent les phases de requête et de sélection d'une recherche de saisie semi-automatique d'un utilisateur dans une session distincte à des fins de facturation. La session commence lorsque l'utilisateur commence à saisir une requête et se termine lorsqu'il sélectionne un lieu. Chaque session peut comporter plusieurs requêtes, suivies d'une sélection d'emplacement. Une fois la session terminée, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Nous vous recommandons d'utiliser des jetons de session pour toutes les sessions de saisie semi-automatique programmatiques. Lorsque vous intégrez un fragment ou lancez la saisie semi-automatique à l'aide d'un intent, l'API s'en charge automatiquement.

Le SDK Places pour Android utilise un élément AutocompleteSessionToken pour identifier chaque session. Votre application doit transmettre un nouveau jeton de session au démarrage de chaque nouvelle session, puis transmettre ce même jeton, ainsi qu'un ID de lieu, lors de l'appel suivant à fetchPlace() afin de récupérer les détails sur le lieu sélectionné par l'utilisateur.

En savoir plus sur les jetons de session

Limiter les résultats de la saisie semi-automatique

Vous pouvez limiter les résultats de la saisie semi-automatique à une zone géographique spécifique et/ou les filtrer en fonction d'un ou de plusieurs types de lieux, ou de cinq pays au maximum. Vous pouvez appliquer ces contraintes à l'activité de saisie semi-automatique, à AutocompleteSupportFragment et aux API de saisie semi-automatique programmatique.

Pour limiter les résultats, procédez comme suit:

• Pour préférencer les résultats dans la région définie, appelez setLocationBias() (certains résultats provenant de l'extérieur de la région définie peuvent toujours être renvoyés).
• Pour n'afficher que les résultats situés dans la région définie, appelez setLocationRestriction() (seuls les résultats situés dans la région définie sont renvoyés).
• Pour ne renvoyer que les résultats conformes à un type de lieu particulier, appelez setTypesFilter() (par exemple, si vous spécifiez TypeFilter.ADDRESS, seuls les résultats avec une adresse précise seront renvoyés).
• Pour ne renvoyer des résultats que dans cinq pays spécifiés, appelez setCountries(). Les pays doivent être transmis sous la forme d'un code pays à deux caractères compatible avec la norme ISO 3166-1 Alpha-2.

Limiter les résultats à une région spécifique

Pour limiter les résultats de la saisie semi-automatique à une région géographique spécifique, appelez setLocationBias() en transmettant un RectangularBounds. L'exemple de code suivant montre comment appeler setLocationBias() sur une instance de fragment pour orienter ses suggestions de saisie semi-automatique vers une région de Sydney, en Australie.

    autocompleteFragment.setLocationBias(
        RectangularBounds.newInstance(
            LatLng(-33.880490, 151.184363),
            LatLng(-33.858754, 151.229596)
        )
    )

      

    autocompleteFragment.setLocationBias(RectangularBounds.newInstance(
            new LatLng(-33.880490, 151.184363),
            new LatLng(-33.858754, 151.229596)));

      

Limiter les résultats à une région spécifique

Pour limiter les résultats de la saisie semi-automatique à une zone géographique spécifique, appelez setLocationRestriction() en transmettant un RectangularBounds. L'exemple de code suivant montre comment appeler setLocationRestriction() sur une instance de fragment pour orienter ses suggestions de saisie semi-automatique vers une région de Sydney, en Australie.

    autocompleteFragment.setLocationRestriction(
        RectangularBounds.newInstance(
            LatLng(-33.880490, 151.184363),
            LatLng(-33.858754, 151.229596)
        )
    )

      

    autocompleteFragment.setLocationRestriction(RectangularBounds.newInstance(
            new LatLng(-33.880490, 151.184363),
            new LatLng(-33.858754, 151.229596)));

      

Remarque:Cette restriction n'est appliquée qu'à des routes entières. Des résultats synthétiques situés en dehors des limites rectangulaires peuvent être renvoyés en fonction d'un itinéraire qui chevauche la restriction d'emplacement.

Filtrer les résultats par type de lieu ou par collection de types

Vous pouvez limiter les résultats d'une requête de saisie semi-automatique afin qu'ils ne renvoient qu'un certain type de lieu. Spécifiez un filtre à l'aide des types de lieux ou d'une collection de types répertoriés dans les tableaux 1, 2 et 3 de la page Types de lieux. Si rien n'est spécifié, tous les types sont renvoyés.

Pour filtrer les résultats de la saisie semi-automatique, appelez setTypesFilter() afin de définir le filtre.

Pour spécifier un type ou un filtre de collection de types:

• Appelez setTypesFilter() et spécifiez jusqu'à cinq valeurs de type des tableaux 1 et 2 affichés dans les types de lieux. Les valeurs de type sont définies par les constantes de PlaceTypes.

• Appelez setTypesFilter() et spécifiez une collection de types issue du tableau 3 de la page Types de lieux. Les valeurs des collections sont définies par les constantes dans PlaceTypes.

  Un seul type du Tableau 3 est autorisé dans la requête. Si vous spécifiez une valeur du Tableau 3, vous ne pouvez pas spécifier de valeur du Tableau 1 ni du Tableau 2. Sinon, une erreur se produit.

L'exemple de code suivant appelle setTypesFilter() sur un AutocompleteSupportFragment et spécifie plusieurs valeurs de type.

    autocompleteFragment.setTypesFilter(listOf("landmark", "restaurant", "store"))

      

    autocompleteFragment.setTypesFilter(Arrays.asList("landmark", "restaurant", "store"));

      

L'exemple de code suivant montre comment appeler setTypesFilter() sur un AutocompleteSupportFragment pour définir un filtre qui ne renvoie que des résultats avec une adresse précise en spécifiant une collection de types.

    autocompleteFragment.setTypesFilter(listOf(PlaceTypes.ADDRESS))

      

    autocompleteFragment.setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS, PlaceTypes.ESTABLISHMENT));

      

L'exemple de code suivant montre comment appeler setTypesFilter() sur un IntentBuilder pour définir un filtre qui ne renvoie que des résultats avec une adresse précise en spécifiant une collection de types.

    val intent = Autocomplete.IntentBuilder(AutocompleteActivityMode.FULLSCREEN, fields)
        .setTypesFilter(listOf(PlaceTypes.ADDRESS))
        .build(this)

      

    Intent intent = new Autocomplete.IntentBuilder(
            AutocompleteActivityMode.FULLSCREEN, fields)
            .setTypesFilter(Arrays.asList(PlaceTypes.ADDRESS))
            .build(this);

      

Filtrer les résultats par pays

Pour filtrer les résultats de la saisie semi-automatique jusqu'à cinq pays, appelez setCountries() pour définir le code pays. Transmettez ensuite le filtre à un fragment ou un intent. Les pays doivent être transmis sous la forme d'un code pays à deux caractères compatible avec la norme ISO 3166-1 Alpha-2.

L'exemple de code suivant montre comment appeler setCountries() sur un AutocompleteSupportFragment pour définir un filtre ne renvoyant que les résultats dans les pays spécifiés.

    autocompleteFragment.setCountries("AU", "NZ")

      

    autocompleteFragment.setCountries("AU", "NZ");

      

Limites d'utilisation

Votre utilisation de l'API Places, y compris du SDK Places pour Android, n'est plus limitée à un nombre maximal de requêtes par jour (QPD). Toutefois, les limites d'utilisation suivantes s'appliquent toujours:

• La limite de débit est de 6 000 RPM (requêtes par minute). Il correspond à la somme des requêtes côté client et côté serveur pour toutes les applications utilisant les identifiants du même projet.

Afficher les mentions dans votre application

• Si votre application utilise le service de saisie semi-automatique de manière programmatique, votre UI doit afficher une attribution "Powered by Google" ou apparaître dans une carte Google.
• Si votre application utilise le widget de saisie semi-automatique, aucune action supplémentaire n'est requise (l'attribution requise est affichée par défaut).
• Si vous récupérez et affichez des informations supplémentaires sur un lieu après avoir obtenu un lieu par ID, vous devez également afficher les attributions tierces.

Pour en savoir plus, consultez la documentation sur les attributions.

Optimisation de Place Autocomplete

Cette section décrit les bonnes pratiques pour vous aider à exploiter au mieux le service Place Autocomplete.

Voici quelques consignes générales :

• Le moyen le plus rapide de développer une interface utilisateur fonctionnelle consiste à utiliser le widget Autocomplete de l'API Maps JavaScript, le widget Autocomplete du SDK Places pour Android ou la commande d'interface utilisateur Autocomplete du SDK Places pour iOS.
• Développez dès le départ vos connaissances des champs de données Place Autocomplete essentiels.
• Les champs de pondération et de restriction de lieu sont facultatifs, mais peuvent avoir un impact important sur les performances de la saisie semi-automatique.
• Utilisez la gestion des erreurs pour vérifier que votre application se dégrade correctement si l'API renvoie une erreur.
• Assurez-vous que votre application fonctionne lorsqu'il n'y a aucune sélection et qu'elle propose aux utilisateurs un moyen de poursuivre.

Bonnes pratiques liées à l'optimisation des coûts

Optimisation de base des coûts

Pour optimiser le coût d'utilisation du service Place Autocomplete, utilisez des masques de champ dans les widgets Place Details et Place Autocomplete afin de ne renvoyer que les champs de données de lieu dont vous avez besoin.

Optimisation avancée des coûts

Envisagez d'implémenter Place Autocomplete de manière programmatique pour accéder au tarif par requête et demander des résultats d'API Geocoding pour le lieu sélectionné plutôt que pour Place Details. La tarification par requête associée à l'API Geocoding est plus rentable que la tarification par session (basée sur la session) si les deux conditions suivantes sont remplies :

• Si vous n'avez besoin que de la latitude/longitude ou de l'adresse du lieu sélectionné par l'utilisateur, l'API Geocoding fournit ces informations à un prix inférieur à celui d'un appel Place Details.
• Si les utilisateurs sélectionnent une prédiction de saisie semi-automatique toutes les quatre requêtes de prédiction ou moins en moyenne, la tarification par requête peut être plus rentable que celle par session.

Votre application nécessite-t-elle des informations autres que l'adresse et la latitude/longitude de la prédiction sélectionnée ?

Bonnes pratiques liées aux performances

Les consignes suivantes décrivent les méthodes permettant d'optimiser les performances de Place Autocomplete :

• Ajoutez des restrictions locales, une pondération géographique et des préférences linguistiques (pour les implémentations programmatiques) à votre implémentation Place Autocomplete. La préférence linguistique n'est pas obligatoire pour les widgets, car ils sélectionnent cette option dans le navigateur ou l'appareil mobile de l'utilisateur.
• Si Place Autocomplete est accompagné d'une carte, vous pouvez pondérer la position en fonction de la fenêtre d'affichage de la carte.
• Dans les cas où l'utilisateur ne choisit pas l'une des prédictions de la saisie semi-automatique, généralement parce qu'aucune d'entre elles n'est l'adresse souhaitée, vous pouvez réutiliser l'entrée utilisateur d'origine pour essayer d'obtenir des résultats plus pertinents :
  • Si vous pensez que l'utilisateur ne saisira que des informations d'adresse, réutilisez son entrée d'origine dans un appel à l'API Geocoding.
  • Si vous pensez que l'utilisateur saisira des requêtes pour un lieu spécifique avec un nom ou une adresse, utilisez une requête Find Place. Si les résultats ne sont attendus que dans une région spécifique, utilisez la pondération géographique.
  Voici d'autres scénarios dans lesquels il est préférable de revenir à l'API Geocoding :
  • Lorsque des utilisateurs saisissent des compléments d'adresse dans des pays où Place Autocomplete n'est pas totalement compatible avec ce type d'adresses : Estonie, Lituanie et Tchéquie, par exemple. Par exemple, l'adresse tchèque "Stroupežnického 3191/17, Praha" génère une prédiction partielle dans Place Autocomplete.
  • Lorsque des utilisateurs saisissent des adresses qui contiennent un préfixe identifiant une portion de route, par exemple "23-30 29th St, Queens" à New York ou "47-380 Kamehameha Hwy, Kaneohe" sur l'île de Kauai, à Hawaï.

Dépannage

Bien qu'une grande variété d'erreurs puissent se produire, la majorité des erreurs que votre application est susceptible de rencontrer sont généralement dues à des erreurs de configuration (par exemple, la mauvaise clé API a été utilisée ou la clé API n'a pas été configurée correctement) ou à des erreurs de quota (votre application a dépassé son quota). Pour en savoir plus sur les quotas, consultez la section Limites d'utilisation.

Les erreurs qui se produisent lors de l'utilisation des commandes de saisie semi-automatique sont renvoyées dans le rappel onActivityResult(). Appelez Autocomplete.getStatus() pour obtenir le message d'état du résultat.