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

Avrupa Ekonomik Alanı (AEA) geliştiricileri

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

Bu bölümde, bir uygulamanın önizleme sürümünden GA sürümüne nasıl taşınacağı açıklanmaktadır.

Genel kullanıma sunulan sürüme eklenen yeni özellikler

Genel kullanıma sunulan sürümde, önizleme sürümünde yer almayan aşağıdaki yeni özellikler eklenmiştir:

  • Yer kimlikleri ve enlem/boylam koordinatlarının yanı sıra artık GA sürümünde bir konum belirlemek için şunları kullanabilirsiniz:

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

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

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

    • Plus Kodları

      Plus Code'lar, gerçek adresi olmayan kişiler veya yerler için açık adres gibidir. Artı Kodları, sokak adı ve numarası içeren adresler yerine enlem ve boylama dayalıdır ve sayı ve harf olarak gösterilir.

  • compute routes response artık geocodingResults dizisini içeriyor. İstek içinde adres dizesi veya Plus Code olarak belirtilen her konum (başlangıç, hedef veya ara nokta) için API, yer kimliği araması yapar. Bu dizinin her bir öğ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 önizleme özelliklerinde yapılan değişiklikler

Artık aşağıdaki özellikleri istek URL'sine yeni dizi extraComputations alanını ekleyerek GA'da açıkça etkinleştirmeniz 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 isteği parametresini ayarlayın.
  • Yanıt içinde döndürülecek bilgileri belirtmek için bir alan maskesi ayarlayın.

Bilmeniz gerekenler:

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

  • travelAdvisory.tollInfo (Ücretli geçiş bilgileri)

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(Ücretli geçiş bilgileri)
  • routes.travelAdvisory.tollInfo(Ücretli geçiş 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: