Navigasyon noktası jetonlarını kullanarak rota oluşturma

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Navigasyon noktası jetonları, daha iyi rota oluşturma ve sürücü deneyimi için bir hedefle ilgili önemli bağlamsal bilgileri Android için Navigasyon SDK'sına, iOS için Navigasyon SDK'sına veya Routes API'ye göndermenize olanak tanır. Bu, yiyecek teslimatı veya araç paylaşımı gibi durumlarda faydalıdır. Bu durumlarda, kullanıcının girişi olmadan teslim alma veya bırakma noktası belirsiz olabilir.

Bir gezinme noktası jetonu oluşturup iletmek için Geocoding API'nin Destinations yöntemini kullanarak kullanıcılarınızın gezinme noktaları listesinden tercih ettikleri konumu seçmelerine olanak tanıyın. Kullanıcının seçimi, Geocoding API'nin Destinations yöntemi tarafından döndürülen bir gezinme noktası haline gelir.

Ardından, hem hedef koordinatlarını hem de bağlamsal bilgileri içeren gezinme noktası jetonunu Android için Navigation SDK'ya, iOS için Navigation SDK'ya veya Routes API'ye iletebilirsiniz. Bu SDK'larda ve API'de, kesin rota oluşturma için bir ara nokta oluşturulur. Hedef, sürücü için Navigation SDK tarafından jetonun ilişkili olduğu yere göre vurgulanır.

Örnek: Araç paylaşımı kullanım alanı

Genel Bakış

Bu örnekte, rota fiyatını hesaplayan ve sürücüleri doğru teslim alma noktasına yönlendiren bir araç paylaşımı uygulaması oluşturmak için Geocoding API, Routes API ve iOS veya Android için Navigation SDK'nın nasıl birleştirileceği gösterilmektedir.

Özet olarak adımlar şunlardır:

  1. Geocoding API aracılığıyla bir gezinme noktası jetonu alın.
  2. Rotayı hesaplamak ve bir rota jetonunda kodlamak için Routes API'yi kullanın.
  3. Hem navigasyon noktası jetonunu hem de rota jetonunu Navigasyon SDK'sına iletin.
  4. Sürücüyü doğru teslim alma noktasına yönlendirmek için Navigation SDK'yı kullanın.

İlgili Rotalar API'si, iOS için Navigasyon SDK'sı ve Android için Navigasyon SDK'sı dokümanlarının bağlantıları için Daha fazla bilgi bölümüne bakın.

Bu diyagram, bir araç paylaşma veya teslimat uygulamasının, bir sürücüyü rota jetonu ve gezinme noktası jetonu kullanarak yönlendirmek için Geocoding API, Routes API ve Navigation SDK for iOS veya Android'i nasıl kullanacağını gösterir:

Araç paylaşımı veya teslimat kullanım alanı şeması
Araç paylaşımı veya teslimat kullanım alanının şeması

Araç paylaşımı örneği

Tüketicinin yolculuk rezervasyonu yapması için bir uygulama, sürücünün yolculuk bildirimi ve varış noktasına giden rota bilgilerini alması için de ikinci bir uygulama olduğunu düşünelim.

Bu resimde, navigasyon noktasının seçildiği bir tüketiciye yönelik araç paylaşımı uygulaması ve sürücüyü tam olarak yönlendirmek için Android Navigation SDK'sını kullanan bir sürücü uygulaması örnekleri gösterilmektedir.

Tüketici ve sürücü uygulamalarına örnekler

Tüketici uygulamayı açtığında uygulama, Geocoding API'nin Destinations yöntemini çağırır ve tüketiciye olası gezinme noktaları seçimi sunar:

Tüketicinin teslimat noktası seçmesi

Kullanıcı, SearchDestinations isteğinin yanıt gövdesindeki navigationPoints dizisinde yer alan tercih ettiği noktayı seçer:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

Uygulama arka ucu, rotayı hesaplamak ve rota jetonunu almak için Routes API'ye gezinme noktası jetonunu sağlar.

Son olarak, hem gezinme noktası jetonu hem de rota jetonu, sürücüyü doğru teslim alma noktasına yönlendirmek için bir ara nokta oluşturmak üzere iOS veya Android için Navigation SDK'yı kullanan bir mobil sürücü uygulamasına iletilir.

Daha fazla bilgi