Tüketici SDK'sı planlanmış görevlerine genel bakış
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Tüketicilerin planlanmış teslimatlarının veya hizmet siparişlerinin ilerleme durumunu takip etmelerine olanak tanıyarak planlanmış görevler için tüketici deneyimini özelleştirin.
Planlanmış görevler için Consumer SDK nedir?
Tüketici SDK'sı, Fleet Engine'in planlanmış görevler için bir özelliğidir. Bu özellik, tüketici deneyimi oluşturmaya yönelik araç kitlerini de içerir. Bu araç kitleri, sürücünün ilerlemesini görselleştirmek ve planlanmış bir durakla ilişkili görevin durumunu göstermek için harita tabanlı görüntüler oluşturmanıza olanak tanır. Bu ürün iki temel kitle için tasarlanmıştır:
- Tek bir kargo siparişinin teslimat durumunu öğrenmek isteyen tüketici son kullanıcılar. Bu belgede,
FleetEngineShipmentLocationProvider sınıfını ve ilişkili arayüzleri sağlayan JavaScript'teki Consumer SDK ile bu tüketici deneyiminin nasıl uygulanacağı açıklanmaktadır.
- Tüm araç filosunun teslimat ve araç durumunu izlemek isteyen filo operatörleri. Filoları izleme hakkında bilgi edinmek için Filo izleme rehberi'ne göz atın.
Planlanmış görevler için neden Consumer SDK'yı kullanmalısınız?
Consumer SDK'yı planlanmış görevler tüketici uygulamalarınıza entegre etmek, neredeyse gerçek zamanlı konum güncellemeleri ve yola sabitlenmiş konumlarla kapsamlı bir tüketici deneyimi sunmanıza olanak tanır. Tüketicileriniz, gönderilerinin nerede olduğunu anlamalarına yardımcı olan teslimat aracının konumunu ve ilerleme ayrıntılarını görebilir.
Consumer SDK ile yapabilecekleriniz
Aşağıdaki kargo bilgilerini tüketicilerinizle paylaşmak için Consumer SDK'yı kullanın:
- Teslimat aracının haritadaki gerçek zamanlı konumu.
- Paketin varışıyla ilgili tahmini süre (trafik gibi değişen koşullara göre ayarlanır).
- Aracın kullandığı rota.
- Kargolarının teslim edilmesine kadar kalan mesafe ve durak sayısı.
Ayrıca, tüketici uygulamanızda veya web sitenizde, Driver SDK'sından alınan konum bilgilerine dayalı olarak diğer sorunsuz coğrafi konum özellikli tüketici deneyimleri de oluşturabilirsiniz. Sürücü SDK'sı ile ilgili ayrıntılar için Sürücü SDK'sında planlanmış görevlere genel bakış başlıklı makaleyi inceleyin.
Tüketici SDK'sı bileşenleri
JavaScript Consumer SDK aşağıdaki bileşenleri içerir:
- Standart bir
google.maps.Map öğesinin yerine kullanılabilen bir JavaScript harita bileşeni.
- Fleet Engine ile bağlanılacak veri bileşenleri.
- Aracın ve rotanın hedefe doğru ilerlerken görselleştirilmesine yönelik bileşenler.
- Sürücünün tahmini varış zamanı veya sürüş için kalan mesafeyle ilgili ham veri feed'leri.
Aşağıdaki tabloda bileşenler açıklanmaktadır.
| Bileşen |
Açıklama |
|---|
| Harita görünümü |
Harita görünümü, aracın ilerleme durumunu gösterir ve araç rotası boyunca hareket ettikçe görünümü günceller. |
| Kargo konumu sağlayıcı |
Kargo takip sağlayıcı, haritanın kargoyla ilgili faydalı bilgiler (ör. kargonun teslim alınacağı veya teslim edileceği yer ile teslimat aracının konumu ve rotası) gösterebilmesi için bir konum feed'i sağlar.
|
| Kimlik doğrulama jetonu alıcı |
Kimlik doğrulama jetonu alıcı, Fleet Engine'de depolanan konum verilerine erişimi doğrulamak için arka uç sunucunuzdan JSON Web Jetonları (JWT'ler) alır. JavaScript Yolculuk Paylaşımı Kitaplığı'nı kullanarak web uygulamanızda kimlik doğrulama jetonu alıcıyı uygularsınız. Ayrıca arka uç sunucunuzda Fleet Engine için bir JSON Web Token (JWT) oluşturma hizmeti de uygulamanız gerektiğini unutmayın. |
| Harita stili seçenekleri |
Haritanızın varsayılan stilini web uygulamanızın stiline uyacak şekilde değiştirmek için özel stil seçeneklerini kullanabilirsiniz. |
Tüketici SDK'sını kullanma
| 1 |
JavaScript Consumer SDK'sını ayarlama |
Daha fazla bilgi için JavaScript Consumer SDK'sını ayarlama başlıklı makaleyi inceleyin. |
| 2 |
Gönderiyi takip etme |
Haritayı başlatma, gönderiyi takip etmeye başlama ve takibi durdurma ile ilgili bilgileri öğrenin. Kargoyu takip etme başlıklı makaleyi inceleyin. |
| 3 |
Harita arayüzünü özelleştirme |
Planlanmış görevler için JavaScript Consumer SDK'sını kullanarak harita arayüzünü özelleştirebilir, işaretçi özelleştirmesi sağlayabilir veya çoklu çizgileri şekillendirebilirsiniz. Harita stili,
İşaretçileri özelleştirme ve
Çoklu çizgileri özelleştirme bölümlerine bakın. |
Sırada ne var?
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-31 UTC."],[[["\u003cp\u003eThe Consumer SDK enables businesses to provide customers with real-time visibility into the location and progress of their scheduled deliveries or service orders.\u003c/p\u003e\n"],["\u003cp\u003eThis SDK offers tools for creating map-based displays within consumer applications, showing the driver's location, estimated time of arrival, and route information.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can integrate the Consumer SDK to create a comprehensive and seamless delivery tracking experience for their customers, improving transparency and satisfaction.\u003c/p\u003e\n"],["\u003cp\u003eKey components of the SDK include a map view, a location provider, authentication mechanisms, and customizable styling options to tailor the experience.\u003c/p\u003e\n"],["\u003cp\u003eTo begin, developers need to set up the JavaScript Consumer SDK, follow a specific shipment for tracking, and customize the map interface as desired.\u003c/p\u003e\n"]]],[],null,["Tailor the consumer experience for scheduled tasks by allowing consumers to\nfollow the progress of their scheduled deliveries or service orders.\n\nWhat is the Consumer SDK for scheduled tasks?\n\nThe Consumer SDK is a feature of Fleet Engine for scheduled tasks that also\nincludes toolkits to create the consumer experience. These toolkits let you\ncreate map-based displays to visualize a driver's\nprogress and show the status of the task associated with a scheduled stop. It's\ndesigned for two primary audiences:\n\n- **Consumer end users** who want to know delivery status for an individual shipment order. This document covers how to implement that consumer experience with the Consumer SDK in JavaScript, which provides the `FleetEngineShipmentLocationProvider` class and associated interfaces.\n- **Fleet operators** who want to track the delivery and vehicle status for an entire fleet of vehicles. For information about tracking fleets, see the [Fleet tracking guide](/maps/documentation/mobility/operations/fleet-tracking).\n\nWhy use the Consumer SDK for scheduled tasks?\n\nIntegrating the Consumer SDK into your scheduled tasks consumer applications\nlets you provide a comprehensive consumer experience, with near real-time\nlocation updates and road-snapped positions. Your consumers can see the delivery\nvehicle's location and progress details that help them understand where their\nshipment is.\n\nWhat can you do with the Consumer SDK?\n\nUse the Consumer SDK to share the following shipment information with your\nconsumers:\n\n- Delivery vehicle's real-time position on a map.\n- ETA for package arrival, adjusted for changing circumstances, such as traffic.\n- Route the vehicle is taking.\n- Distance and number of stops remaining before their shipment is delivered.\n\nYou can also create other seamless geo-enabled consumer experiences inside your\nconsumer app or website based on location information from the Driver SDK. For\ndetails about the Driver SDK, see the\n[Driver SDK scheduled tasks overview](/maps/documentation/mobility/driver-sdk/scheduled).\n\nConsumer SDK components\n\nThe JavaScript Consumer SDK contains the following components:\n\n- A JavaScript map component that is a drop-in replacement for a standard `google.maps.Map` entity.\n- Data components to connect with Fleet Engine.\n- Components for visualization of the vehicle and route as it progresses to a destination.\n- Raw data feeds for a driver's ETA or the remaining distance to drive.\n\nThe following table describes the components.\n\n| Component | Description |\n|------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Map view | The map view illustrates the progress of the vehicle, updating the view as the vehicle moves along its route. |\n| Shipment location provider | The shipment tracking provider provides a location feed so that the map can display useful information about the shipment, such as the pickup or delivery location of the shipment and the location and route of the delivery vehicle. |\n| Authentication token fetcher | The authentication token fetcher gets JSON Web Tokens (JWTs) from your backend server to authenticate access to the location data stored in Fleet Engine. You implement an authentication token fetcher as part of your web application using the JavaScript Journey Sharing Library. Note that you must also implement a JSON Web Token (JWT) creation service for Fleet Engine on your backend server. |\n| Map style options | You can use custom styling options to change the default styling of your map to match the styling of your web application. |\n\nHow to use the Consumer SDK\n\n|---|----------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Set up the JavaScript Consumer SDK** | For more information, see [Set up the JavaScript Consumer SDK](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/setup). |\n| 2 | **Follow a shipment** | Learn how to initialize the map, start following a shipment, and stop following with appropriate clean up. See [Follow a shipment](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/follow). |\n| 3 | **Customize the map interface** | You can use the JavaScript Consumer SDK for scheduled tasks to customize the map interface, provide marker customization, or style polylines. See [Style a map](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/style-map), [Customize markers](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/customize-markers), and [Customize polylines](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/customize-polylines). |\n\nWhat's next\n\n- [Set up the JavaScript Consumer SDK](/maps/documentation/mobility/journey-sharing/scheduled/shipment-tracking/setup)"]]
