Rotaları 3D haritada görüntüleme

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Rotaları hesaplayıp <gmp-map-3d> öğesinde iki şekilde oluşturabilirsiniz:

  • Route3DElement (<gmp-route-3d>) ile bildirimli olarak: Routes API'den yol tarifi isteyen ve 3D rota çoklu çizgilerini, başlangıç ve hedef işaretçilerini ve rota özeti popover'ını oluşturan bir web bileşeni ekleyin.
  • Route yardımcı yöntemleriyle programatik olarak: Ara noktalar, özel alan maskeleri veya özel çoklu çizgi stilleri gerektiğinde Route.computeRoutes yöntemini çağırın ve rotayı create3DPolylines, createWaypointMarkers ve createPopover yöntemlerine iletin.

Her iki yaklaşım da Maps JavaScript API'nin v=beta kanalında kullanılabilir. Beta kanalını yükleme talimatları için Sürüm oluşturma başlıklı makaleyi inceleyin.

Ön koşullar ve faturalandırma

3D rotaları görüntülemeden önce Google Cloud projenizi oluşturun ve bu proje için hem Maps JavaScript API'yi hem de Routes API'yi etkinleştirin. Hem maps3d hem de routes kitaplıklarını yükleyin.

<gmp-map-3d> oluşturma, Dinamik 3D Haritalar (Immersive Maps Pro) kapsamında faturalandırılır. <gmp-route-3d> veya Route.computeRoutes tarafından yapılan her rota isteği, istenen özelliklere göre bir Rotalar API'si Compute Routes SKU'su kapsamında faturalandırılır:

Yapılandırma Routes SKU katmanı
Varsayılan rota istekleri (TRAFFIC_UNAWARE veya trafik çoklu çizgileri olmadan WALKING, BICYCLING ve TRANSIT seyahat modları) Compute Routes Essentials
routing-preference, traffic-aware veya traffic-aware-optimal olarak ayarlanmış ve traffic-polylines-disabled etkinleştirilmiş Compute Routes Pro
routing-preference, traffic-aware olarak ayarlanmış veya traffic-aware-optimal, trafiğe göre renklendirilmiş çoklu çizgiler etkinleştirilmiş (trafiğe duyarlı bir tercih ayarlandığında varsayılan olarak kullanılır) Compute Routes Enterprise

SKU ayrıntıları için Maps JavaScript API Kullanımı ve Faturalandırması başlıklı makaleyi inceleyin.

HTML kullanarak 3D rota ekleme

Bir başlangıç noktası ile varış noktası arasındaki rotayı minimum kodla görüntülemek için <gmp-route-3d> öğesini <gmp-map-3d> içine yerleştirin ve autofits-camera ekleyin. Böylece harita, rotayı otomatik olarak çerçeveler:

<gmp-map-3d
  style="height: 400px; width: 100%;"
  mode="hybrid">
  <gmp-route-3d
    origin="Space Needle, Seattle, WA"
    destination="Tacoma Dome, Tacoma, WA"
    travel-mode="driving"
    routing-preference="traffic-aware"
    autofits-camera>
  </gmp-route-3d>
</gmp-map-3d>

<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d,routes">
</script>

YOUR_API_KEY kısmını Google Haritalar Platformu API anahtarınızla değiştirin.

Route3DElement, çoklu çizgi ve özet popover renklerini üst öğe <gmp-map-3d>'in açık veya koyu renk şemasıyla otomatik olarak eşleştirir ve aşağıdaki özellikleri destekler:

  • origin ve destination: "lat,lng" koordinat dizesi, "places/ChIJ-bfVTh8VkFQRDZLQnmioK9s" gibi bir yer kaynağı adı veya adres dizesi kabul eder. JavaScript'te bu özellikler LatLng, LatLngLiteral, LatLngAltitude, LatLngAltitudeLiteral ve Place nesnelerini de kabul eder.
  • travel-mode (travelMode): driving (varsayılan), walking, bicycling veya transit değerlerini kabul eder (çok formatlı yürüme ve toplu taşıma hattı segmentlerini oluşturur).
  • routing-preference (routingPreference): traffic-unaware, traffic-aware veya traffic-aware-optimal değerlerini kabul eder.
  • traffic-polylines-disabled (trafficPolylinesDisabled): Trafiğe duyarlı rotalarda trafik hızına göre çoklu çizgi renklendirmesini devre dışı bırakır. Böylece istek, Compute Routes Enterprise yerine Compute Routes Pro kapsamında faturalandırılır.
  • departure-time (departureTime): HTML'de "2027-03-15T16:00:00Z" gibi bir ISO 8601 zaman damgası dizesini veya JavaScript'te bir Date nesnesini kabul eder.
  • autofits-camera (autofitsCamera): Yüklenen rotayı <gmp-map-3d> görüntü alanında çerçeveler.

Rota etkinliklerini işleme ve rota verilerini okuma

Route3DElement, bir rotanın oluşturulması tamamlandığında gmp-load, rota hesaplaması başarısız olursa veya sıfır rota döndürürse gmp-error gönderir. gmp-load tetiklendikten sonra hesaplanan routes, fallbackInfo ve geocodingResults özelliklerini okuyabilirsiniz:

const routeElement = document.querySelector('gmp-route-3d');

routeElement.addEventListener('gmp-load', () => {
  const primaryRoute = routeElement.routes?.[0];
  console.log('Distance (m):', primaryRoute?.distanceMeters);
  console.log('Duration:', primaryRoute?.localizedValues?.duration);
});

routeElement.addEventListener('gmp-error', () => {
  console.error('Failed to load the 3D route.');
});

gmp-route-3d yerine rota yardımcı yöntemleri ne zaman kullanılır?

<gmp-route-3d>, varsayılan işaretçi ve çoklu çizgi stiliyle tek bir origin ile destination arasındaki birincil rotayı oluşturur. Ara yol noktaları, alternatif rota seçimi, özel yanıt alanı maskeleri veya özel çoklu çizgi ve işaretçi stilleri gerektiğinde 3D yardımcı yöntemleriyle Route.computeRoutes kullanın.

Route sınıfıyla 3D rota oluşturmayı özelleştirme

Özel 3D rota iş akışları için Route.computeRoutes yöntemini çağırın ve döndürülen Route örneğini, 3D yardımcı yöntemlerini kullanarak <gmp-map-3d> üzerinde oluşturun:

<div id="map-container" style="height: 400px; width: 100%;"></div>

<script>
  async function initMap() {
    const { Map3DElement, MapMode } =
      await google.maps.importLibrary('maps3d');
    const { Route } = await google.maps.importLibrary('routes');

    const map = new Map3DElement({
      mode: MapMode.HYBRID,
    });
    document.getElementById('map-container').append(map);

    const { routes } = await Route.computeRoutes({
      origin: '1800 Amphibious Blvd., Mountain View, CA 94045',
      destination: 'San Francisco Ferry Building, San Francisco, CA',
      travelMode: 'DRIVING',
      routingPreference: 'TRAFFIC_AWARE',
      extraComputations: ['TRAFFIC_ON_POLYLINE'],
      fields: ['path', 'speedPaths', 'localizedValues'],
    });

    const route = routes?.[0];
    if (!route) return;

    const [polylines, markers, popover] = await Promise.all([
      route.create3DPolylines({
        polylineOptions: {
          strokeWidth: 10,
          autofitsCamera: true,
        },
      }),
      route.createWaypointMarkers(),
      route.createPopover(),
    ]);

    map.append(...polylines, ...markers, popover);
  }
</script>
<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&loading=async&callback=initMap">
</script>

YOUR_API_KEY kısmını Google Haritalar Platformu API anahtarınızla değiştirin.

Çağırdığınız her yardımcı yöntem için ComputeRoutesRequest.fields içindeki zorunlu alanları ekleyin:

  • create3DPolylines: Standart çoklu çizgiler için 'path' veya 'legs', travelMode 'TRANSIT' olduğunda 'path' ve 'legs' ya da trafik renkli çoklu çizgiler için extraComputations: ['TRAFFIC_ON_POLYLINE'] ile 'speedPaths' isteyin. polylineOptions öğesini özelleştirmek için RoutePolyline3DOptions değerini iletin veya trafficPolylinesDisabled değerini ayarlayın.
  • createWaypointMarkers: fields içinde 'path' isteyin. Başlangıç ve varış noktası işaretçileri oluşturur (varsayılan olarak Marker3DElement veya CreateWaypointMarkersOptions içinde markerClass ile belirtildiğinde MarkerElement, MarkerInteractiveElement ya da Marker3DInteractiveElement). Ara noktalar bu yöntemle oluşturulmaz.
  • createPopover: Bir özet PopoverElement öğesini rota yolunun ortasına sabitlemek için 'path' ve 'localizedValues' (toplu taşıma rotaları için 'legs') isteyin.

Sonraki adımlar