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

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

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

Navigasyon noktası jetonu oluşturup iletmek için Geocoding API'nin Destinations yöntemini kullanarak kullanıcılarınızın navigasyon 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 navigasyon noktası olur.

Ardından, hem hedef koordinatları hem de bağlamsal bilgileri içeren navigasyon noktası jetonunu Android için Navigasyon SDK'sı, iOS için Navigasyon SDK'sı veya Routes API'ye iletebilirsiniz. Bu API'lerde, hassas rota çizimi için bir ara nokta oluşturulur. Hedef, jetonun ilişkili olduğu yere göre Navigation SDK tarafından sürücü için 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 Navigasyon SDK'sının nasıl birleştirileceği gösterilmektedir.

Genel olarak adımlar şunlardır:

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

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

Bu diyagramda, bir araç paylaşımı veya teslimat uygulamasının, rota jetonu ve navigasyon noktası jetonu kullanarak bir sürücüyü yönlendirmek için Geocoding API, Routes API ve iOS veya Android için Navigasyon SDK'sını nasıl kullanacağı gösterilmektedir:

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

Araç paylaşımı örneği

Tüketicinin yolculuk rezervasyonu yapması için bir uygulamanın, sürücünün yolculuk bildirimini ve varış noktasına giden rota bilgilerini alması için ikinci bir uygulamanın olduğu bir araç paylaşımı senaryosu düşünün.

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

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

Tüketici, tüketici uygulamasını açtığında uygulama, Geocoding API'nin Destinations yöntemini çağırır ve tüketiciye olası navigasyon noktaları sunar:

Bırakma noktası seçen tüketici

Kullanıcı, tercih ettiği noktayı seçer. Bu nokta, bir SearchDestinations isteğinin yanıt gövdesindeki navigationPoints dizisinden biridir:

"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 navigasyon noktası jetonunu Routes API'ye sağlar.

Son olarak, hem navigasyon 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 Navigasyon SDK'sını kullanan bir mobil sürücü uygulamasına iletilir.

Daha fazla bilgi