Utilizzare le polilinee

Sviluppatori dello Spazio economico europeo (SEE)

Il metodo computeRoutes restituisce la route rappresentata da una polilinea come parte della risposta. Puoi richiedere due tipi di polilinee:

  • Polilinea di base (impostazione predefinita), rappresenta un percorso ma senza informazioni sul traffico incorporate nella polilinea. Le richieste che restituiscono una polilinea di base vengono fatturate alla tariffa di Routes Basic. Scopri di più sulla fatturazione per l'API Routes.
  • Polilinea sensibile al traffico, contiene informazioni sulle condizioni del traffico lungo il percorso. Le condizioni del traffico sono espresse in termini di categorie di velocità (NORMAL, SLOW, TRAFFIC_JAM) applicabili a un determinato intervallo della polilinea. Le richieste di polilinee sensibili al traffico vengono fatturate alla tariffa Routes Preferred. Scopri di più sulla fatturazione per l'API Routes.
  • Polilinea multimodale, contiene i dettagli del trasporto pubblico e le informazioni sul traffico. Le richieste di polilinee multimodali vengono fatturate alla tariffa di Routes Preferred. Scopri di più sulla fatturazione per l'API Routes.

Polilinea di base (predefinita)

Una polilinea è rappresentata da un oggetto Polyline; un percorso è un array di coordinate LatLngAltitude. Per restituire una polilinea di base, chiama il metodo computeRoutes con la proprietà fields impostata su path, quindi chiama il metodo createPolylines sull'istanza della route per ottenere un oggetto Polyline.

Il seguente esempio mostra come richiedere una polilinea di 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.
};

Polilinea consapevole del traffico

Per richiedere una polilinea in base al traffico, aggiungi le seguenti proprietà alla richiesta:

  1. Imposta la proprietà travelMode su DRIVING.
  2. Imposta la proprietà routingPreference su TRAFFIC_AWARE.
  3. Imposta la proprietà extraComputations su TRAFFIC_ON_POLYLINE.
  4. Specifica i campi path, speedPaths e routeLabels.

L'esempio seguente mostra come richiedere una polilinea in base al traffico:

// 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'],
};

Visualizzare le polilinee su una mappa

Per visualizzare le polilinee su una mappa, chiama createPolylines sull'oggetto itinerario, poi utilizza il metodo setMap per impostare la mappa della polilinea sull'oggetto mappa. L'oggetto mappa viene utilizzato per visualizzare la polilinea sulla mappa.

L'esempio seguente mostra come visualizzare una polilinea su una mappa:

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