Pourquoi utiliser l'API Distance Matrix ?
Vous pouvez utiliser l'API Distance Matrix pour déterminer les itinéraires les plus efficaces entre plusieurs points de départ et destinations possibles. (par exemple, les nœuds de calcul à envoyer aux sites de tâches ou les entrepôts depuis lesquels envoyer des packages).
Que pouvez-vous faire avec l'API Distance Matrix ?
Avec l'API Distance Matrix, vous pouvez fournir la distance et le temps de trajet pour une matrice de points de départ et de destinations. Vous pouvez spécifier plusieurs options, y compris le mode de transport (en voiture, à vélo, en transports en commun ou à pied) et les modes de transport (bus, métro, train, tramway ou train).
L'API Distance Matrix fournit des informations basées sur l'itinéraire recommandé entre les points de départ et d'arrivée. Vous pouvez demander les types de données de distance suivants:
- Distance pour le mode de transport sélectionné
- Distance en kilomètres ou en miles
- Temps de trajet estimé en fonction des embouteillages
Fonctionnement de l'API Distance Matrix
L'API Distance Matrix utilise un nombre illimité de points de départ (points de départ) et de destinations, et renvoie la distance et le temps de trajet entre chaque point de départ et toutes les destinations demandées, en commençant par le premier point de départ de la requête, puis en allant jusqu'au suivant.
Par exemple, si votre requête spécifie A et B comme points de départ, et C et D comme destinations, elle renvoie les distances et le temps de trajet dans l'ordre suivant:
- De A à C
- A à D
- De B à C
- De B à D
L'exemple suivant présente une requête pour deux points de départ : Washington, DC et Boston, avec une seule destination, New York, NY, au format JSON:
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=New%20York%20City%2C%20NY &origins=Washington%2C%20DC%7CBoston &units=imperial &key=YOUR_API_KEY
Ressources
Le tableau suivant récapitule les ressources disponibles via l'API Distance Matrix, ainsi que les données renvoyées.
Ressources de données | Données renvoyées | Format de retour |
---|---|---|
Distance Matrix
Indiquez les points de départ et les destinations sous forme d'ID de lieu, d'adresses ou de coordonnées de latitude/longitude. |
|
|
Utiliser l'API Distance Matrix
1 | Configuration | Commencez par Configurer votre projet Google Cloud et suivez les instructions de configuration qui suivent. |
2 | Essayer une requête distance Matrix | Une fois que vous disposez d'une clé API, vous pouvez commencer à tester l'API Distance Matrix directement depuis votre navigateur. Consultez la section Exemples de requêtes du guide de démarrage pour obtenir des exemples. |
3 | Rédiger une requête plus complexe | Essayez une requête qui fournit plusieurs points de départ et destinations. Découvrez les paramètres facultatifs permettant de contraindre des calculs, tels que l'heure de départ spécifiée ou les restrictions d'itinéraire. Consultez la section Paramètres facultatifs dans le guide Requêtes et réponses Distance Matrix. |
4 | Comprendre les principes de base des réponses | Explorez les réponses de données pour vous préparer à utiliser les données de la matrice des distances pour votre application. Pour en savoir plus, consultez Réponses de la matrice des distances. |
5 | Intégrez des données de distance Matrix à votre propre application. | Vous pouvez utiliser ces données pour calculer la distance et le temps de trajet. |
Bibliothèques clientes disponibles
Appelez cette API dans le langage de votre choix via l'une des bibliothèques clientes suivantes:
- Client Java pour les services Google Maps
- Client Python pour les services Google Maps
- Client Go pour les services Google Maps
- Client Node.js pour les services Google Maps
Les clients Java, Python, Go et Node.js pour les services Google Maps sont des bibliothèques clientes gérées par la communauté, disponibles en Open Source sous la licence Apache 2.0. Téléchargez-les depuis GitHub, où vous trouverez également des instructions d'installation et un exemple de code.
Étapes suivantes
- Commencez à utiliser Distance Matrix: cliquez sur Get Started (Premiers pas).
- Premiers pas avec des exemples de requêtes et de réponses: consultez Requête et réponse Distance Matrix.
- Suivez les bonnes pratiques: consultez les bonnes pratiques concernant les services Web.