Découverte locale avec Nearby Search

Dans ce document, vous allez découvrir comment utiliser l'API Nearby Search (New) pour créer une solution simple et économique

une expérience de découverte locale.

Une expérience de découverte locale montre aux utilisateurs les principaux lieux d'intérêt à proximité d'un emplacement que vous spécifiez lorsqu'ils recherchent un hôtel ou un bien immobilier. Il se compose souvent d'une carte interactive, avec un panneau supplémentaire contenant un sélecteur de lieux et une galerie de photos. Vous découvrirez différents produits et fonctionnalités de Google Maps Platform pour améliorer l'expérience grâce à l'interactivité.

exemple de découverte locale

Cas d'utilisation

Voyons maintenant quels éléments de l'intégration de la découverte locale sont utiles pour les utilisateurs :

  • Découverte : donnez aux utilisateurs un aperçu de ce qui se trouve autour d'un lieu unique en affichant des lieux pertinents de différents types.

  • Interactivité : permettez aux utilisateurs de sélectionner un lieu et d'actualiser les données de manière dynamique.

    par rapport à ce lieu.

  • Visualisation : fournir des avis et des photos sur des lieux

    ainsi que la durée et la distance de marche, pour que les utilisateurs puissent rapidement déterminer si l'itinéraire leur convient.

Architecture de référence

alt_text

Découverte locale

Il existe de nombreuses façons de créer une expérience de découverte locale. L'intégration suivante est un exemple personnalisé d'expérience utilisateur qui exploite des API Google Maps Platform bien connues, ainsi que de nouvelles fonctionnalités intéressantes. Si vous souhaitez adopter une approche basée sur des modèles pour la découverte locale, vous pouvez utiliser des composants Web.

Exemple d'application

Exemple de tutoriel

Le tableau ci-dessous présente l'exemple d'application décomposé en étapes, ainsi qu'une description de l'implémentation technique avec les API Google Maps Platform.

1. Recherche de lieux avec saisie semi-automatiqueRechercher un lieu

  • Chargez l'API Maps JavaScript.
  • Requête Place Autocomplete ou sélection d'un lieu sur la carte.

exemple de saisie semi-automatique

2. Mettez en avant les points d'intérêt locaux à l'aide de l'API Nearby Search (New).

  • Classement par popularité (résultats plus pertinents) ou par distance.
  • includedTypes, excludedTypes ; si vous êtes un hôtel, vous pouvez exclure le type "lodging" et n'inclure que les types appropriés, par exemple : "restaurant, cafe, park, tourist_attraction".
  • Utilisez includedPrimaryTypes et excludedPrimaryTypes pour contrôler encore mieux les résultats.
  • "locationRestriction" pour éviter un nombre insuffisant de résultats ou des lieux trop éloignés. En cas de résultat nul, élargissez la taille du cercle / rectangle avant d'afficher les résultats.

exemples de lieux à proximité

Exemple de requête lors de la réservation d'un hôtel avec les champs de données demandés :

  • De base (displayName, types, openingHours, formattedAddress)
  • Contact (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Préféré (reviews, priceLevel, userRatingCount)
 { "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

Exemple de requête lors de la recherche d'un bien immobilier avec les champs de données demandés :

  • De base (displayName, types, openingHours, formattedAddress)
 { "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

3. Ajoutez de l'interactivité avec Dynamic Maps et l'API Directions.

  • Sections et étapes à jour en interrogeant l'API Directions. * Utilisez l'heure dans la section suivante.

exemples d'itinéraires

4. Afficher des informations détaillées sur le lieu lors de l'interaction

  1. Description : displayName, types, rating, userRatingCount, priceLevel.

    Heure : provient de la requête précédente de l'API Directions.

  2. Avis : reviews[i].author, reviews[i].rating,reviews[i].text.

  3. Images : pendant la preview sans restriction de l'API Nearby Search (New), vous devrez interroger Place Details avec place.id pour obtenir photo_reference, puis les interroger une par une dans votre expérience.

détails sur les lieux

Nombre de requêtes et coût associé

Conclusion

Une expérience de découverte locale est un moyen efficace d'offrir de la valeur aux utilisateurs. Cette démonstration comprend de nombreuses fonctionnalités que vous êtes susceptible d'inclure lorsque vous créez une telle expérience sur Google Maps Platform, avec des fonctionnalités spéciales de l'API Nearby Search (New) .

Étapes suivantes

Suggestions de lecture :

Contributeurs

Auteurs principaux :

Thomas Anglaret | Ingénieur solutions Google Maps Platform