จัดรูปแบบแผนที่

เอกสารนี้ครอบคลุมวิธีปรับแต่งรูปลักษณ์ของแผนที่ รวมถึงควบคุม ตัวเลือกการแสดงข้อมูลและวิวพอร์ต ซึ่งทำได้โดยใช้วิธีต่อไปนี้

  • ใช้การจัดรูปแบบแผนที่ในระบบคลาวด์
  • ตั้งค่าตัวเลือกรูปแบบแผนที่ในโค้ดของคุณเองโดยตรง

จัดรูปแบบแผนที่ด้วยการจัดรูปแบบแผนที่ในระบบคลาวด์

หากต้องการใช้รูปแบบแผนที่กับแผนที่การแชร์การเดินทางของผู้บริโภคใน JavaScript ให้ระบุ mapId และ mapOptions อื่นๆ เมื่อสร้าง JourneySharingMapView

ตัวอย่างต่อไปนี้แสดงวิธีใช้รูปแบบแผนที่ด้วยรหัสแผนที่

JavaScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

TypeScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

จัดรูปแบบแผนที่ในโค้ดของคุณเองโดยตรง

นอกจากนี้ คุณยังปรับแต่งรูปแบบแผนที่ได้โดยการตั้งค่าตัวเลือกแผนที่เมื่อสร้าง JourneySharingMapView ตัวอย่างต่อไปนี้แสดงวิธีจัดรูปแบบแผนที่โดยใช้ ตัวเลือกแผนที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกแผนที่ที่คุณตั้งค่าได้ที่ mapOptions ในเอกสารอ้างอิง Maps JavaScript API ของ Google

JavaScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

TypeScript

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

ควบคุมระดับการเข้าถึงข้อมูลงานของ SDK

คุณควบคุมระดับการมองเห็นของออบเจ็กต์งานบางอย่างบนแผนที่ได้โดยใช้ กฎการมองเห็น

ระดับการเข้าถึงเริ่มต้นของข้อมูลงาน

โดยค่าเริ่มต้น ข้อมูลสำหรับงานที่มอบหมายให้กับยานพาหนะจะมองเห็นได้เมื่อยานพาหนะอยู่ภายใน 5 ป้ายจอดของงาน สิทธิ์ในการเข้าถึงจะสิ้นสุดเมื่อมีการ ยกเลิกหรืองานเสร็จสมบูรณ์

ตารางนี้แสดงระดับการแชร์เริ่มต้นสำหรับงานแต่ละประเภท คุณปรับแต่งระดับการเข้าถึงสำหรับงานหลายอย่างได้ แต่ไม่ใช่ทั้งหมด ดูรายละเอียดเพิ่มเติมเกี่ยวกับประเภทงานได้ที่ประเภทงานในคู่มืองานที่กำหนดเวลาไว้

ประเภทงาน การแสดงผลเริ่มต้น ปรับแต่งได้ไหม คำอธิบาย
งานการไม่พร้อมให้บริการ ไม่แสดง ไม่ ใช้สำหรับเวลาพักและเติมน้ำมันของคนขับ หากเส้นทางไปยังงานนำส่ง มีจุดจอดของยานพาหนะอื่นด้วย ระบบจะไม่แสดงจุดจอดนั้น หากมีเฉพาะงานที่ระบุว่าไม่พร้อมให้บริการ ระบบจะยังคงแสดงเวลาที่คาดว่าจะถึง และเวลาที่คาดว่าจะทำงานเสร็จสำหรับงานนำส่ง เอง
เปิดงานเกี่ยวกับยานพาหนะ แสดง ใช่ สิทธิ์ในการมองเห็นจะสิ้นสุดเมื่อมีการยกเลิกหรือทำงานเสร็จ คุณปรับแต่งระดับการแชร์ของงานเกี่ยวกับยานพาหนะที่เปิดอยู่ได้ ดูปรับแต่งระดับการเข้าถึงของงานเกี่ยวกับ ยานพาหนะที่เปิดอยู่
งานยานพาหนะที่ปิดแล้ว ไม่แสดง ไม่ คุณปรับแต่งระดับการเข้าถึงของงานยานพาหนะที่ปิดแล้วไม่ได้

ปรับแต่งระดับการเข้าถึงของงานยานพาหนะที่เปิดอยู่

อินเทอร์เฟซ TaskTrackingInfo มีองค์ประกอบข้อมูลงานหลายอย่าง ที่สามารถแสดงได้ด้วย Consumer SDK

องค์ประกอบข้อมูลงานที่ปรับแต่งได้

เส้นประกอบของเส้นทาง

เวลาถึงโดยประมาณ

เวลาโดยประมาณในการทำงานให้เสร็จสมบูรณ์

ระยะทางที่เหลือในการขับรถไปยังงาน

จำนวนป้ายรถเมล์ที่เหลือ

ตำแหน่งของยานพาหนะ

ตัวเลือกระดับการมองเห็นต่องาน

คุณปรับแต่งการกำหนดค่าระดับการมองเห็นได้ทีละงานโดยการตั้งค่าTaskTrackingViewConfigเมื่อสร้างหรืออัปเดตงานภายใน Fleet Engine ใช้ตัวเลือกการมองเห็นต่อไปนี้เพื่อสร้างเกณฑ์ในการ กำหนดการมองเห็นขององค์ประกอบงาน

ตัวเลือกระดับการมองเห็น

จำนวนป้ายรถเมล์ที่เหลือ

ระยะเวลาจนถึงเวลาถึงโดยประมาณ

ระยะทางที่เหลือในการขับ

แสดงเสมอ

ไม่แสดง

ตัวอย่างเช่น สมมติว่าการปรับแต่งตัวอย่างจะปรับระดับการมองเห็นสำหรับองค์ประกอบข้อมูล 3 รายการโดยใช้เกณฑ์ที่แสดงในตารางต่อไปนี้ องค์ประกอบอื่นๆ ทั้งหมด จะเป็นไปตามกฎการมองเห็นเริ่มต้น

องค์ประกอบข้อมูลที่จะปรับ ระดับการแชร์ เกณฑ์
เส้นประกอบของเส้นทาง แสดง ยานพาหนะอยู่ภายใน 3 ป้าย
เวลาถึงโดยประมาณ แสดง ระยะทางที่เหลือในการขับขี่สั้นกว่า 5,000 เมตร
จำนวนป้ายรถเมล์ที่เหลือ ไม่แสดง ยานพาหนะอยู่ภายใน 3 ป้าย

ตัวอย่างต่อไปนี้แสดงการกำหนดค่านี้

"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "estimatedArrivalTimeVisibility": {
    "remainingDrivingDistanceMetersThreshold": 5000
  },
  "remainingStopCountVisibility": {
    "never": true
  }
}

เส้นประกอบของเส้นทางและกฎการแสดงผลตำแหน่งของยานพาหนะ

เส้นหลายเส้นของเส้นทางจะมองไม่เห็น เว้นแต่ตำแหน่งของยานพาหนะจะมองเห็นด้วย เช่นกัน มิฉะนั้น ระบบจะอนุมานตำแหน่งของยานพาหนะได้จากจุดสิ้นสุดของ เส้นหลายเส้น

หลักเกณฑ์เหล่านี้จะช่วยให้คุณระบุชุดค่าผสมที่ถูกต้องสำหรับตัวเลือกเส้นประกอบของเส้นทางและตัวเลือกการมองเห็นตำแหน่งของยานพาหนะ

ตัวเลือกระดับการมองเห็นเดียวกัน เกณฑ์การมองเห็น คำแนะนำ
ตัวเลือกเส้นหลายเส้นของเส้นทางตั้งค่าให้มองเห็นได้เสมอ ตั้งค่าให้ตำแหน่งของยานพาหนะแสดงอยู่เสมอ
ตั้งค่าตำแหน่งของยานพาหนะเป็นไม่แสดง ตั้งค่าเส้นหลายส่วนของเส้นทางให้ไม่แสดง
ตัวเลือกระดับการเข้าถึงมีดังนี้
  • จำนวนป้ายรถเมล์ที่เหลือ
  • ระยะเวลาจนกว่าจะถึงเวลาถึงโดยประมาณ
  • ระยะทางที่เหลือในการขับ

ตั้งค่าตัวเลือก Polyline ของเส้นทางให้มีค่าน้อยกว่าหรือเท่ากับค่าที่ตั้งไว้ สำหรับตำแหน่งของยานพาหนะ เช่น

    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingStopCountThreshold": 5
      },
    }
ตัวเลือกระดับการมองเห็นต่างๆ เกณฑ์การมองเห็น คำแนะนำ
ตำแหน่งยานพาหนะแสดงอยู่

ซึ่งจะเกิดขึ้นเมื่อเป็นไปตามทั้งตัวเลือกตำแหน่งยานพาหนะและตัวเลือกการแสดงผลเส้นหลายเส้น เช่น

  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "vehicleLocationVisibility": {
      "remainingDrivingDistanceMetersThreshold": 3000
    },
  }

ในตัวอย่างนี้ ตำแหน่งของยานพาหนะจะแสดงก็ต่อเมื่อจำนวนป้ายรถเมล์ที่เหลืออยู่มีอย่างน้อย 3 ป้ายและระยะทางที่เหลืออยู่มีอย่างน้อย 3, 000 เมตร

ปิดใช้การปรับอัตโนมัติ

คุณหยุดไม่ให้แผนที่ปรับวิวพอร์ตให้พอดีกับยานพาหนะและเส้นทางที่คาดการณ์ไว้โดยอัตโนมัติได้โดยปิดใช้การปรับให้พอดีอัตโนมัติ ตัวอย่างต่อไปนี้ แสดงวิธีปิดใช้การปรับอัตโนมัติเมื่อกำหนดค่ามุมมองแผนที่การแชร์การเดินทาง

JavaScript

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

TypeScript

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

ขั้นตอนถัดไป