Navigasyon noktalarına giden rota

Android için Navigasyon SDK'sı, ara noktaları veya navigasyon noktalarını belirtmek için gelişmiş yöntemler sunar. Bu sayede, özellikle birden fazla girişi veya belirli navigasyon noktaları olan varış noktaları için daha doğru rota ve daha iyi bir varış deneyimi sunar. Bir konumu ve ek rota bağlamını kodlayan bir dize olan navigationPointToken kullanarak tam konumlara rota oluşturabilirsiniz. Daha fazla bağlam bilgisi için enlem ve boylam koordinatlarını bir yer kimliğiyle de birleştirebilirsiniz.

Arka plan

7.4 sürümünden önce, enlem ve boylam koordinatlarını veya yer kimliğini kullanarak Waypoint tanımlayabiliyordunuz. Yalnızca enlem ve boylam bilgisine göre rota oluşturmak bazen etkili olsa da özellikle büyük mekanlar, parklar veya birden fazla girişi olan binalar için ideal olmayan bırakma ya da alma noktalarına yönlendirebilir. Sonuç, en yakın yol segmentine sabitlenebilir. Bu segment, en uygun veya doğru navigasyon noktası olmayabilir.

Gelişmiş ara nokta seçenekleri, daha fazla bağlam sağlanmasına olanak tanıyarak bu sorunu çözer.

Navigasyon noktası jetonu kullanma

Girişler, yükleme alanları veya belirlenmiş teslim alma alanları gibi belirli navigasyon noktalarına en hassas rotayı çizmek için navigationPointToken kullanabilirsiniz. Bu jeton, Geocoding API'nin destinations yöntemini çağırarak alınır. Bir yerle ilişkili belirli, rotası çizilebilir bir navigasyon noktasını temsil eder.

Navigasyon noktası jetonu belirtmek için:

1. Geocoding API yanıtının SearchDestinations yönteminden bir navigationPointToken elde edin.
2. Oluşturucuda setNavigationPointToken() yöntemini kullanarak Waypoint oluşturun.

// Assuming 'navPointToken' is a String obtained from the destinations method of the Geocoding API
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithToken = Waypoint.builder()
    .setTitle(destinationName)
    .setNavigationPointToken(navPointToken)
    .build();

// Use this waypoint in navigator.setDestinations()

Navigasyon noktası jetonlarını ve rota jetonlarını kullanma

Geocoding API aracılığıyla bir navigasyon noktası jetonu alabilir, rota jetonu almak için bu jetonu Routes API isteğinde kullanabilir ve ardından yalnızca rota jetonunu Navigation SDK'ya iletebilirsiniz. Rota jetonu, navigasyon noktası jetonunun hassasiyetini korur. Bu, yolculuk fiyatını hesaplamak için Routes API'yi kullandığınız ve navigasyon noktası jetonunun hassasiyetini istediğiniz araç paylaşımı veya teslimat gibi senaryolarda kullanışlıdır.

Rota jetonu sayesinde Navigasyon SDK'sı, fiyatı hesaplamak için kullandığınız rotada navigasyonu başlatır. Bu sayede, yolculuk için daha uzun veya daha kısa rotaların kullanılması riski azalır ve "fiyat şokları" önlenir.

Routes API'deki navigasyon noktası jetonları ve rota jetonları hakkında daha fazla bilgi için Rota için konumları belirtme ve Rota jetonu alma başlıklı makaleleri inceleyin. Rota jetonu kullanarak rota planlamayı öğrenmek için Rota planlama başlıklı makaleyi inceleyin.

Aşağıdaki şemada, bir araç paylaşımı veya teslimat uygulamasının navigasyon noktası jetonlarını ve rota jetonlarını birlikte nasıl kullanacağı gösterilmektedir. 8.1 sürümünden itibaren sürücü uygulaması, 7. adımda Navigation SDK'ya yalnızca rota jetonunu iletir.

Yer kimliği ile enlem ve boylamı birleştirme

7.4 sürümünden itibaren, Waypoint oluştururken hem yer kimliği hem de enlem ve boylam koordinatlarını sağlayabilirsiniz. Bu yöntem, genel yerin bağlamını (yer kimliği) sağlarken kesin bir nokta (enlem/boylam) belirtmek istediğinizde kullanışlıdır. Bu sayede Navigasyon SDK'sı, varış noktasındaki binayı vurgulayarak veya yer kimliğiyle ilgili yakındaki önemli yerleri göstererek daha zengin bir varış deneyimi sunabilir.

// Assuming 'placeId' is the Place ID String
// Assuming 'lat' and 'lng' are the double values for latitude and longitude
// Assuming 'destinationName' is a String title for the waypoint

Waypoint waypointWithPlaceIdAndLatLng = Waypoint.builder()
    .setTitle(destinationName)
    .setPlaceIdString(placeId)
    .setLatLng(lat, lng)
    .build();

// Use this waypoint in navigator.setDestinations()

Dikkat edilmesi gereken noktalar

Hem placeId hem de latlng sağladığınızda:

• Rota, öncelikli olarak belirtilen latlng hedefler.
• placeId, varış deneyimini iyileştirmek için bağlam olarak kullanılır.
• Yedek: SDK, sağlanan placeId değerinin, verilen latlng değerinden çok uzak bir özelliğe karşılık geldiğini belirlerse placeId yok sayılır. Bu senaryoda rota yalnızca latlng için oluşturulur ve yere özgü varış deneyimi geliştirmeleri kullanılamaz.

Geçerli ara nokta yapılandırmalarının özeti