Önizleme sürümünden taşıma

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

Routes API, Eylül 2022'de genel önizleme (GKST öncesi) olarak yayınlandı. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özel Şartlar'a tabidir. Daha fazla bilgi için lansman aşaması açıklamalarına bakın.

Bu bölümde, bir uygulamanın önizleme sürümünden genel kullanıma sunulan sürüme nasıl taşınacağı açıklanmaktadır.

GKST sürümüne eklenen yeni özellikler

Genel kullanıma sunulan sürüm, önizlemeye dahil edilmeyen aşağıdaki yeni özellikleri ekler:

  • GA sürümünde artık yer kimlikleri ve enlem/boylam koordinatlarının yanı sıra aşağıdakileri kullanarak konum belirtebilirsiniz:

    • Adres dizeleri ("Chicago, IL" veya "Darwin, NT, Avustralya")

      Adres dizeleri, kullanıcıların adres girdiği yöntemdir. Ancak {product_name}, bir rota hesaplayabilmek için önce adres dizesini dahili olarak coğrafi kodlayarak enlem/boylam koordinatlarına dönüştürmelidir.

      Ayrıca, belirli bir coğrafi bölge için coğrafi kodlanmış sonuçların döndürülmesini belirtmenize olanak tanıyan regionCode istek parametresi için destek eklendi.

    • Plus Kodlar

      Plus Code'lar, gerçek adresi olmayan kişiler veya yerler için açık adresler gibidir. Plus Kodlar, sokak adları ve numaraları içeren adresler yerine enlem ve boylamı temel alır ve sayı ile harf olarak gösterilir.

  • compute routes response artık geocodingResults dizisini içeriyor. API, istekte adres dizesi veya Plus Code olarak belirtilen her konum (başlangıç, varış veya ara nokta) için yer kimliği araması yapar. Bu dizinin her öğesi, bir konuma karşılık gelen yer kimliğini ve konumla ilgili ek meta verileri içerir. İsteklerde yer kimliği veya enlem/boylam koordinatları olarak belirtilen konumlar yoksayılır.

Mevcut özellik önizlemelerinde yapılan değişiklikler

Artık aşağıdaki özellikleri GA'da etkinleştirmek için isteğe yeni dizi extraComputations alanını eklemeniz gerekir:

Önizleme sürümünde, yanıtta bu özelliklerle ilgili bilgilerin döndürülmesini belirtmek için alan maskesi kullanıyordunuz. Şimdi ikinizin de yapması gerekenler:

  • Bu özellikleri etkinleştirmek için yeni extraComputations dizi istek parametresini ayarlayın.
  • Yanıtın hangi bilgileri döndüreceğini belirtmek için bir alan maskesi ayarlayın.

Bilmeniz gerekenler:

Aşağıdaki alanlar, extraComputations ayarlanarak açıkça etkinleştirilmediği sürece computeRouteMatrix yanıtlarına dahil edilmeyecektir:

  • travelAdvisory.tollInfo (Ücret bilgisi)

Aşağıdaki alanlar, extraComputations ayarlanarak açıkça etkinleştirilmediği sürece artık computeRoutes yanıtlarına dahil edilmeyecek:

  • routes.legs.travelAdvisory.tollInfo(Ücret bilgisi)
  • routes.travelAdvisory.tollInfo(Ücret bilgileri)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Yakıt tüketimi)
  • routes.travelAdvisory.speedReadingIntervals(Çoklu çizgi üzerindeki trafik)
  • routes.legs.travelAdvisory.speedReadingIntervals(Çoklu çizgi üzerindeki trafik)

Ne yapmanız gerekiyor?

Bir çoklu çizgi üzerindeki ücretli yol bilgileri, yakıt tüketimi veya trafikle ilgili yanıt alanlarını almak için yeni istek dizisi alanı extraComputations'yı aşağıdaki değerlerden birini veya daha fazlasını içerecek şekilde ayarlamanız gerekir:

  • Ücret bilgilerini almak için yeni extraComputations dizi alanını "TOLLS" olarak ayarlayın.

  • Yakıt tüketimi verilerini almak için yeni extraComputations dizi alanını "FUEL_CONSUMPTION" olarak ayarlayın.

  • Çoklu çizgilerde trafik bilgisi almak için yeni extraComputations dizi alanını "TRAFFIC_ON_POLYLINE" olarak ayarlayın.