Dans ce document, vous allez apprendre à utiliser l'API Nearby Search (nouvelle version) à créer une plate-forme simple et rentable
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 établissement. que vous spécifiez lorsque vous recherchez un hôtel ou un bien immobilier. Il s'agit souvent carte interactive, avec un panneau supplémentaire contenant un sélecteur de lieu et un de photos. Vous verrez différentes versions de Google Maps Platform des produits et des fonctionnalités pour améliorer l'interactivité.
Cas d'utilisation
Voyons maintenant quels éléments de l'intégration de la détection locale incitent les utilisateurs :
Découverte : donnez aux utilisateurs un aperçu de ce qui se trouve autour d'un lieu donné. 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 que les utilisateurs comprennent rapidement s’il convient 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. Les éléments suivants : est un exemple personnalisé d'expérience utilisateur qui exploite bien les API Google Maps Platform, ainsi que de nouvelles fonctionnalités intéressantes. Si vous vous souhaitez adopter une approche modélisée de la découverte locale. Vous pouvez utiliser des Composants.
Exemple d'application
Exemple de tutoriel
Vous trouverez dans le tableau sous l'exemple d'application décomposé en étapes et une description de la mise en œuvre technique avec Google Maps API 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 "hébergement" et n'incluent que les types adaptés (par exemple, "restaurant, café, parc, tourit_attraction".- Utilisez
includedPrimaryTypes
etexcludedPrimaryTypes
pour encore plus d'avantages un contrôle total sur les résultats. - "locationRestriction" pour éviter un nombre insuffisant de résultats ou trop éloigné lieux ; S'il n'y a AUCUN résultat, élargissez la taille du cercle / rectangle avant pour 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 les étapes en interrogeant Directions Google Cloud. * 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: lors de l'aperçu sans restriction de l'API Nearby Search (nouvelle), vous devront interroger Places Détails avec
place.id
pour obtenir photo_reference puis d'interroger les données les unes après les autres
Nombre de requêtes et coût associé
- Maps JavaScript API: 1 carte au chargement de l'expérience.
- API Places Autocomplete: une requête par caractère saisi (si vous utilisez la Saisie semi-automatique (un widget), il peut être personnalisé.
- Nearby Search (nouveau) API: 1 requête toutes les 20 lieux affichés. Facturation différente en fonction du Lieu données qui font partie de la réponse à la requête.
- Itinéraire API: 1 requête pour chaque lieu sélectionné par l'utilisateur.
- Place Photo API: 1 requête par photo affichée.
Conclusion
Une expérience de découverte locale est un moyen efficace d'apporter de la valeur à l'utilisateur. Ce l'implémentation de la démonstration comporte de nombreuses fonctionnalités que vous êtes susceptible d'inclure lorsque créer une telle expérience sur Google Maps Platform avec des fonctionnalités spéciales de l'API Nearby Search (nouvelle version)
É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 | Google Maps Platform Solutions Engineer