Dans ce document, vous allez apprendre à utiliser l'API Nearby Search (nouvelle) pour créer une application simple et économique.
de découverte en local.
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 s'agit 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 de Google Maps Platform vous seront présentés afin d'améliorer l'expérience en offrant une expérience interactive.
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é : permettez aux utilisateurs de sélectionner un lieu et d'actualiser les données de manière dynamique.
par rapport à ce lieu.
Visualisation : fournissez des avis et des photos sur des lieux.
et le temps de trajet à pied et la distance pour permettre aux utilisateurs de déterminer rapidement si elle répond à leurs besoins.
Architecture de référence
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 les 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
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 lieu avec AutocompleteSearch
- Chargez l'API Maps JavaScript.
- une requête Places Autocomplete ou un lieu sur la carte ;
2. Afficher des points d'intérêt locaux avec l'API Nearby Search (nouvelle version)
- 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, tourit_attraction".- Utilisez
includedPrimaryTypes
etexcludedPrimaryTypes
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 ; si aucun résultat n'est obtenu, élargissez la taille du cercle / rectangle avant d'afficher les résultats.
Exemple de requête lors de la réservation d'un hôtel avec des champs de données demandés:
- De base (
displayName
,types
,openingHours
,formattedAddress
) - Contact (
websiteUri
,nationalPhoneNumber
,internationalPhoneNumber
) - À privilégier (
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 des 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. Favoriser l'interactivité avec l'API Dynamic Maps et Directions
- Actualisez l'étape et la procédure en interrogeant l'API Directions. * Répartir le temps dans la section suivante
4. Afficher des informations détaillées sur le lieu lors d'une interaction
Description:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Time (Heure) : provient de la requête précédente de l'API Directions.
Avis:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.Images: pendant l'aperçu sans restriction de l'API Nearby Search (nouvelle), vous devrez interroger Places Details avec
place.id
pour obtenir photo_reference, puis interroger une par une dans votre expérience.
Nombre de requêtes et coût associé
- API Maps JavaScript : une carte au chargement de l'expérience.
- API Places Autocomplete: une requête par caractère saisi (si vous utilisez le widget Autocomplete) et personnalisable
- API Nearby Search (nouvelle) : une requête tous les 20 lieux affichés. Facturation différente en fonction des données de lieu qui font partie de la réponse à la requête.
- API Directions : une requête pour chaque lieu sélectionné par l'utilisateur.
- API Place Photo : une requête pour chaque photo affichée.
Conclusion
Une expérience de découverte locale est un moyen efficace d'apporter de la valeur à l'utilisateur. Cette démonstration d'implémentation comporte de nombreuses fonctionnalités que vous êtes susceptible d'inclure lors de la création d'une telle expérience sur Google Maps Platform avec des fonctionnalités spéciales de l'API Nearby Search (nouvelle) .
Étapes suivantes
Documentation complémentaire suggérée:
- Composants Web dans l'API Maps JavaScript
- Optimisation Places Autocomplete
- Autres services Places
- Laissez un commentaire ci-dessous.
Contributeurs
Principaux auteurs:
Thomas Anglaret | Ingénieur en solutions Google Maps Platform