Directions API (eski) veya Distance Matrix API (eski)'den taşıma

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Bu kılavuzda, Directions API veya Distance Matrix API kullanan uygulamaların Routes API'yi kullanmaya nasıl geçirileceği açıklanmaktadır. Routes API hakkında ayrıntılı bilgi için ürüne genel bakış sayfasını inceleyin.

Taşıma işlemi için faturalandırmayla ilgili en iyi uygulamalar

Bu kılavuz, API kullanımınız ikinci kademe fiyatlandırmaya geçecek kadar yüksekse geçerlidir. Bir API'nin daha yeni bir sürümüne geçiş yaparken farklı bir SKU için de faturalandırılırsınız. Geçiş yaptığınız ay içinde maliyetlerin artmasını önlemek için üretimde yeni API'lere ayın başına mümkün olduğunca yakın bir zamanda geçmenizi öneririz. Bu sayede, taşıma ayında en uygun maliyetli aylık fiyatlandırma katmanlarına ulaşırsınız. Fiyatlandırma katmanları hakkında bilgi için fiyatlandırma sayfası ve fiyatlandırma ile ilgili SSS başlıklı makaleleri inceleyin.

REST API uç noktalarını güncelleme

Kodunuzu yeni Routes API uç noktalarını kullanacak şekilde güncelleyin.

Directions API'den

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

Distance Matrix API'den

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

URL parametrelerini HTTPS istek gövdesi kullanacak şekilde dönüştürme

Directions API ve Distance Matrix API'de yapılandırma özelliklerini bir HTTP GET isteğine URL parametreleri olarak iletirsiniz. Örneğin, Directions API için:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

Routes API ile parametreleri bir istek gövdesinde veya üstbilgilerde HTTP POST isteğinin bir parçası olarak iletirsiniz. Örnekler için aşağıdakilere bakın:

Çoklu çizgiyle kodlanmış yol noktalarını konum yol noktalarına dönüştürme

Ara noktaları kodlanmış çoklu çizgiler olarak belirtme özelliği, 16.384 karakterlik URL sınırına çok sayıda ara nokta sığdırmak için Directions API (Eski)'de kullanılabilir. Ara noktalar, REST veya gRPC istek gövdesinde enlem/boylam koordinatları olarak iletilebildiğinden bu özellik, Rotalar API'sinde gerekli değildir. Örnekler için Rota matrisi hesaplama dokümanındaki HTTP Örneği'ne veya Ara yol noktalarını belirtme dokümanındaki Ara yol noktası tanımlama bölümüne bakın.

Parametreleri dönüştürme

Aşağıdaki tabloda, Directions API ve Distance Matrix API'deki yeniden adlandırılan veya değiştirilen parametreler ya da GA sürümünde desteklenmeyen parametreler listelenmektedir. Bu parametrelerden herhangi birini kullanıyorsanız kodunuzu güncelleyin.

İstek parametresi dönüşümleri

Yol tarifi veya mesafe matrisi parametresi Routes API parametresi Notlar
alternatives computeAlternativeRoutes
arrival_time arrivalTime Yalnızca TRANSIT modunda kullanılabilir ve departureTime ile aynı anda kullanılamaz.
avoid routeModifiers
departure_time departureTime arrivalTime ile aynı anda kullanılamaz.
language languageCode Yalnızca Compute Routes için desteklenir.
mode travelMode

computeRoutes veya computeRouteMatrix HTTP POST JSON istek gövdesinde RouteTravelMode değerleri (DRIVE, TWO_WHEELER, WALK, TRANSIT, TRUCK, veya BICYCLE computeRoutes için) GET URL sorgu parametresi yerine iletilir. TWO_WHEELER, TRANSIT ve TRUCK için destek eklendi.
region regionCode
traffic_model trafficModel Daha fazla bilgi
transit_mode "travelMode": "TRANSIT" Directions API'de (Legacy) toplu taşıma rotasında, aynı seyahat moduna (ör. yürüme veya toplu taşıma) sahip bir gezinin her segmenti bir adım olarak kabul edilir ve bu seyahat moduna yönelik ayrı ayrı talimatlar alt adımlarda yer alır. Buna karşılık, Routes API'de adımlar, tüm seyahat türlerinde tutarlı bir şekilde tek bir navigasyon talimatıdır. Yani her navigasyon talimatı bir adımdır. Routes API, tek bir seyahat modundaki birden fazla adım için bu seyahat modundaki adımların özetini içeren meta verileri `stepsOverview` içinde sağlar. Bu meta verileri istemek için `routes.legs.stepsOverview` alan maskesini kullanın. Daha fazla bilgi
transit_routing_preference transitRoutingPreference Daha fazla bilgi
units units Daha fazla bilgi
waypoints intermediates Kodlanmış çoklu çizgiler için destek kaldırıldı.
optimize=true (ara noktalar için) "optimizeWaypointOrder": "true" Daha fazla bilgi

Yanıt parametresi dönüşümleri

Yol tarifi veya mesafe matrisi parametresi Routes API parametresi Notlar
copyrights

Yanıta dahil edilmez. Sonuçları kullanıcılarınıza gösterirken aşağıdaki ifadeyi eklemeniz gerekir:

Powered by Google, ©YEAR Google

Örneğin:

Powered by Google, ©2022 Google
distance distanceMeters Mesafe yalnızca metre cinsinden gösterilir.
duration_in_traffic duration Routes API'de kaldırıldı, duration kullanın.
status Yok. API tarafından bildirilen hatalar için HTTP yanıt kodlarını kullanın. Daha fazla bilgi için İstek hatalarını işleme bölümüne bakın.
geocoded_waypoints geocoding_results Yalnızca Compute Routes için desteklenir. Yalnızca adres olarak belirtilen ara noktalar için coğrafi kodlama yanıtı bilgilerini içerir.
bounds viewport
legs.end_address Yok.

Yüksek doğrulukta rota oluşturma için koordinatlar yerine yer kimliklerini kullanın. Yer kimlikleri, rotayı doğru erişim noktalarına sabitleyen veriler içerir.

  • Adresle başlıyorsanız: Yer Adı Otomatik Tamamlama'yı veya Geocoding API'yi kullanarak adresi yer kimliğine dönüştürün.
  • Koordinatlarla başlıyorsanız: Daha anlamlı bir konum sağlamak için Hedef arama özelliğini kullanabilirsiniz. Yalnızca koordinatlardan adres almak karmaşık olabilir ve yanlış eşleştirmeye yol açabilir. Routes API, koordinatları adreslere tersine coğrafi kodlamaz.
legs.start_address Yok.
overview_polyline polyline
summary description
waypoint_order optimizedIntermediateWaypointIndex