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

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

l'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 lieu 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 Google Maps Platform pour améliorer l'expérience avec l'interactivité.

exemple de découverte locale

Cas d'utilisation

Voyons maintenant quels éléments de l'intégration de la détection locale génèrent de la valeur pour l'utilisateur:

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

  • Interactivité : permet aux utilisateurs de sélectionner un lieu et de mettre à jour dynamiquement les données.

    par rapport à ce lieu.

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

    et le temps et la distance de marche pour que les utilisateurs puissent rapidement comprendre s'il répond à 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'une 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 modélisée de la découverte locale, vous pouvez utiliser les Web Components.

Exemple d'application

Exemple de tutoriel

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

1. Recherche de lieu avec AutocompleteSearch

  • Chargez l'API Maps JavaScript.
  • une requête Places Autocomplete ou un lieu sur la carte ;

exemple de saisie semi-automatique

2. Afficher des points d'intérêt locaux à l'aide de l'API Nearby Search (nouveau)

  • Classement par popularité (résultats plus pertinents) ou classement 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".
  • Tirez parti de includedPrimaryTypes et excludedPrimaryTypes pour encore plus de contrôle sur les résultats.
  • "locationRestriction" pour éviter un nombre insuffisant de résultats ou des lieux trop éloignés ; en cas de zéro résultat, é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:

  • Standard (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 lorsque vous recherchez un bien immobilier avec des champs de données demandés:

  • Standard (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. Ajouter de l'interactivité avec l'API Dynamic Maps and Directions

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

exemples d'itinéraires

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

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

    Heure: provenant 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 version preview sans restriction de l'API Nearby Search (nouvelle version), vous devrez interroger Places Details avec place.id pour obtenir photo_reference, puis interroger une à la fois dans votre expérience.

informations sur les lieux

Nombre de requêtes et coût associé

Conclusion

Une expérience de découverte locale est un moyen efficace de créer de la valeur pour les utilisateurs. Cette implémentation de démonstration comporte 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

Lectures complémentaires suggérées:

Contributeurs

Principaux auteurs:

Thomas Anglaret | Ingénieur solutions Google Maps Platform