Améliorer la découverte à proximité avec l'API Nearby Search (nouvelle)

Dans ce document, vous découvrirez comment utiliser l'API Nearby Search (nouvelle version) pour créer une expérience de découverte locale simple et économique

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.

Elle se compose souvent d'une carte interactive, avec un panneau supplémentaire contenant un sélecteur de lieux et une galerie de photos. Il se compose souvent d'une carte interactive, avec un panneau supplémentaire contenant un sélecteur de lieu et une galerie de photos. Différents produits et fonctionnalités Google Maps Platform vous seront présentés pour améliorer l'expérience grâce à l'interactivité.

Exemple de découverte locale

Cas d'utilisation

Découvrons maintenant les éléments de l'intégration de la découverte locale qui apportent de la valeur aux utilisateurs :

  • Découverte : offrez aux utilisateurs une vue d'ensemble de ce qui se trouve autour d'un lieu unique en présentant des lieux pertinents de différents types.

  • Interactivité : permettez aux utilisateurs de sélectionner un lieu et d'actualiser dynamiquement les données

    associées.

  • Visualisation : fournissez des avis sur les lieux, des photos

    ainsi que le temps et la distance à pied pour que les utilisateurs puissent rapidement déterminer si cela correspond à leurs besoins.

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

Vous trouverez dans le tableau ci-dessous 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.
  • Effectuez une requête Places Autocomplete ou sélectionnez un lieu sur la carte.

exemple de saisie semi-automatique

2. Présentez les points d'intérêt locaux à l'aide de l'API Nearby Search (nouvelle version)

  • Classement par popularité (résultats plus pertinents) ou par distance.
  • includedTypes, excludedTypes : si vous êtes un hôtel, vous pouvez exclure le type "hébergement" et n'inclure que les types adaptés, par exemple : "restaurant, café, parc, attraction touristique".
  • Utilisez includedPrimaryTypes, excludedPrimaryTypes pour contrôler encore plus 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 :

  • Basic (displayName, types, openingHours, formattedAddress)
  • Contact (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Preferred (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 :

  • Basic (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 l'API Dynamic Maps et l'API Directions

  • Itinéraire et étapes à jour en interrogeant l'API Directions. * Utilisez le temps dans la section suivante.

Exemple de consignes

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

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

    Temps : 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 l'aperçu sans restriction de l'API Nearby Search (nouvelle version), vous devrez interroger Places Details avec place.id pour obtenir photo_reference , puis interroger les photos 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 puissant d'apporter de la valeur aux utilisateurs. Cette implémentation de démonstration comporte de nombreuses fonctionnalités que vous êtes susceptible d'inclure lorsque vous créez une expérience de ce type sur Google Maps Platform avec les fonctionnalités spéciales de l'API Nearby Search (nouvelle version) .

Étapes suivantes

Suggestions de lecture :

Contributeurs

Auteurs principaux :

Thomas Anglaret | Ingénieur de solutions Google Maps Platform