Çoklu çizgilerle çalışma

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Fatura adresiniz Avrupa Ekonomik Alanı'ndaysa 8 Temmuz 2025'ten itibaren Hizmetler'i kullanımınızda Google Haritalar Platformu AEA Hizmet Şartları geçerli olacaktır. İşlevler bölgeye göre değişir. Daha fazla bilgi edinin.

computeRoutes yöntemi, yanıtta çoklu çizgiyle gösterilen rotayı döndürür. İki tür çoklu çizgi isteğinde bulunabilirsiniz:

• Temel çoklu çizgi (varsayılan): Bir rotayı temsil eder ancak çoklu çizgiye trafik bilgileri yerleştirilmez. Temel bir poliline döndüren istekler, Rotalar Temel ücreti üzerinden faturalandırılır. Routes API'nin faturalandırılması hakkında daha fazla bilgi edinin.
• Trafiğe duyarlı çoklu çizgi, rota üzerindeki trafik koşulları hakkında bilgi içerir. Trafik koşulları, çoklu çizginin belirli bir aralığında geçerli olan hız kategorileri (NORMAL, SLOW, TRAFFIC_JAM) şeklinde ifade edilir. Trafiğe duyarlı çoklu çizgi istekleri, Tercih Edilen Rotalar fiyatı üzerinden faturalandırılır. Routes API'nin faturalandırılması hakkında daha fazla bilgi edinin.
• Çok formatlı çoklu çizgi, trafik bilgilerinin yanı sıra toplu taşıma bilgilerini de içerir. Çok formatlı çoklu çizgi istekleri, Tercih Edilen Rotalar fiyatı üzerinden faturalandırılır. Routes API'nin faturalandırılması hakkında daha fazla bilgi edinin.

Temel çoklu çizgi (varsayılan)

Çoklu çizgi, Polyline nesnesiyle gösterilir. Yol ise LatLngAltitude koordinat dizisidir. Temel bir çoklu çizgi döndürmek için computeRoutes yöntemini fields özelliği path olarak ayarlanmış şekilde çağırın, ardından Polyline nesnesi almak için rota örneğinde createPolylines yöntemini çağırın.

Aşağıdaki örnekte, temel bir çoklu çizginin nasıl isteneceği gösterilmektedir:

// 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.
};
  

Trafiğe duyarlı çoklu çizgi

Trafiğe duyarlı çoklu çizgi istemek için isteğinize aşağıdaki özellikleri ekleyin:

1. travelMode özelliğini DRIVING olarak ayarlayın.
2. routingPreference özelliğini TRAFFIC_AWARE olarak ayarlayın.
3. extraComputations özelliğini TRAFFIC_ON_POLYLINE olarak ayarlayın.
4. path, speedPaths ve routeLabels alanlarını belirtin.

Aşağıdaki örnekte, trafiğe duyarlı bir çoklu çizginin nasıl isteneceği gösterilmektedir:

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

Çoklu çizgileri haritada görüntüleme

Çoklu çizgileri haritada göstermek için rota nesnesinde createPolylines işlevini çağırın, ardından çoklu çizginin haritasını harita nesnesine ayarlamak için setMap yöntemini kullanın. Harita nesnesi, haritada çoklu çizgi görüntülemek için kullanılır.

Aşağıdaki örnekte, bir çoklu çizginin haritada nasıl gösterileceği açıklanmaktadır:

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