Actualiser les propriétés de recherche

En raison de l'adoption limitée de cette fonctionnalité bêta, la bibliothèque de contexte local incluse dans l'API Maps JavaScript est obsolète depuis la version 3.52.2. Elle continuera de fonctionner jusqu'à nouvel ordre, mais nous vous déconseillons de l'ajouter à de nouveaux projets.

Si vous souhaitez créer vous-même une expérience semblable à la bibliothèque de contexte local, nous vous recommandons d'examiner la solution "Neighborhood Discovery" dans Quick Builder ou d'utiliser la bibliothèque Places de l'API Maps JavaScript. Pour vous aider, des exemples de code et des ateliers de programmation sont à votre disposition.

Ce produit ou cette fonctionnalité sont en phase bêta (pré-DG). La compatibilité des fonctionnalités et produits pré-DG peut être limitée, et il se peut que les modifications apportées à ces fonctionnalités ou produits ne soient pas compatibles avec d'autres versions pré-DG. Les offres en pré-DG sont couvertes par les Conditions spécifiques du service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez effectuer une nouvelle recherche à tout moment une fois que la bibliothèque de contexte local est initialisée. Cela s'avère utile chaque fois que vous devez actualiser les données de contexte local, par exemple lorsque l'utilisateur fait un panoramique sur une nouvelle zone ou si vous avez reporté le chargement initial des données de contexte local en définissant maxPlaceCount sur 0.

Pour déclencher une recherche et actualiser les données de contexte local, effectuez l'une des opérations suivantes :

• Appelez localContextMapView.search() pour actualiser manuellement les données de contexte local lorsqu'il n'est pas nécessaire de modifier les propriétés de recherche actuelles. Si locationRestriction est défini sur null (valeur par défaut), appeler search() actualisera les lieux en fonction de la fenêtre d'affichage actuelle.

L'exemple suivant vous montre comment appeler search() :

    localContextMapView.search();

• Mettez à jour une ou plusieurs propriétés de recherche localContextMapView (maxPlaceCount, placeTypePreferences, locationRestriction, locationBias). Mettre à jour une ou plusieurs de ces propriétés déclenche automatiquement une nouvelle recherche.

Cet exemple montre comment mettre à jour maxPlaceCount et placeTypePreferences :

    localContextMapView.maxPlaceCount = 10;
    localContextMapView.placeTypePreferences: ['bar', 'drugstore']

Si plusieurs modifications de propriété consécutives figurent dans la même pile d'appel, elles sont regroupées et appelées simultanément. Le fait de mettre à jour une propriété vers sa valeur actuelle ne déclenche généralement pas de recherche. Il en va de même pour la mise à jour de propriétés non liées à la recherche.