Utiliser des polylignes

Développeurs de l'Espace économique européen (EEE)

La méthode computeRoutes renvoie l'itinéraire représenté par une polyligne dans la réponse. Vous pouvez demander deux types de polylignes :

  • Polyligne de base (par défaut) : représente un itinéraire, mais sans informations sur le trafic intégrées à la polyligne. Les requêtes qui renvoient une polyligne de base sont facturées au tarif Routes Basic. En savoir plus sur la facturation de l'API Routes
  • Polyligne tenant compte du trafic : contient des informations sur les conditions de circulation le long de l'itinéraire. Les conditions de circulation sont exprimées en termes de catégories de vitesse (NORMAL, SLOW, TRAFFIC_JAM) applicables à un intervalle donné de la polyligne. Les requêtes de polylignes tenant compte du trafic sont facturées au tarif Routes Preferred. En savoir plus sur la facturation de l'API Routes
  • La polyline multimodale contient des informations sur les transports en commun et le trafic. Les requêtes de polylignes multimodales sont facturées au tarif Routes Preferred. En savoir plus sur la facturation de l'API Routes

Polyligne de base (par défaut)

Une polyligne est représentée par un objet Polyline. Un chemin d'accès est un tableau de coordonnées LatLngAltitude. Pour renvoyer une polyligne de base, appelez la méthode computeRoutes avec la propriété fields définie sur path, puis appelez la méthode createPolylines sur l'instance de route pour obtenir un objet Polyline.

L'exemple suivant montre comment demander une polyligne de base :

// Define a basic routes request.
const requestWithBasicPolyline = {
  origin: '155 Steuart St, San Francisco, CA 94105',
  destination: '450 Powell St, San Francisco, CA 94102',
  travelMode: 'WALKING',
  fields: ['path'],  // Request path field to get a polyline.
};

Polyligne tenant compte du trafic

Pour demander une polyligne tenant compte du trafic, ajoutez les propriétés suivantes à votre requête :

  1. Définissez la propriété travelMode sur DRIVING.
  2. Définissez la propriété routingPreference sur TRAFFIC_AWARE.
  3. Définissez la propriété extraComputations sur TRAFFIC_ON_POLYLINE.
  4. Spécifiez les champs path, speedPaths et routeLabels.

L'exemple suivant montre comment demander une polyligne tenant compte du trafic :

// Define a traffic aware routes request.
const requestWithTraffic = {
  origin: '200 King St San Francisco, CA 94107',
  destination: 'Pier 41, San Francisco, CA 94133',
  travelMode: 'DRIVING',
  routingPreference: 'TRAFFIC_AWARE',
  extraComputations: ['TRAFFIC_ON_POLYLINE'],
  fields: ['speedPaths'],
};

Afficher des polylignes sur une carte

Pour afficher des polylignes sur une carte, appelez createPolylines sur l'objet d'itinéraire, puis utilisez la méthode setMap pour définir la carte de la polyligne sur l'objet de carte. L'objet carte permet d'afficher la polyligne sur la carte.

L'exemple suivant montre comment afficher une polyligne sur une carte :

  // Call createPolylines to create polylines for the first route.
  mapPolylines = routes[0].createPolylines();
  // Add polylines to the map.
  mapPolylines.forEach((polyline) => polyline.setMap(map));