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

Routes API, Eylül 2022'de herkese açık bir önizleme (genel kullanıma sunulmadan önce) olarak kullanıma sunuldu. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Ö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 genel sürüme nasıl taşınacağı açıklanmaktadır.

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

Genel kullanıma sunulan sürüme, önizleme sürümünde bulunmayan aşağıdaki yeni özellikler eklendi:

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

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

      Adres dizeleri, kullanıcıların genellikle adres girmek için kullandığı yöntemdir. Ancak {product_name}, 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 döndürmeyi belirtmenize olanak tanıyan regionCode istek parametresi desteği 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 dayanır ve sayılar ile harfler şeklinde gösterilir.

  • Rotaları hesaplama yanıtı artık geocodingResults dizisini içeriyor. API, istekteki her konum (başlangıç, varış noktası veya ara yol noktası) için adres dizesi veya Artı Kodu olarak belirtilmişse yer kimliği araması yapar. Bu dizinin her bir öğesi, konumla ilgili ek meta verilerin yanı sıra konuma karşılık gelen yer kimliğini içerir. İstekteki konumlar, yer kimliği veya enlem/boylam koordinatları olarak belirtilirse yoksayılır.

Mevcut Önizleme özelliklerinde yapılan değişiklikler

Artık isteğe yeni extraComputations dizisi alanını ekleyerek GA'da aşağıdaki özellikleri açıkça etkinleştirmeniz gerekir:

Önizleme sürümünde, yanıtta bu özelliklerin bilgilerini döndürmek için bir alan maskesi kullandınız. Artık şunları yapmanız gerekir:

  • Bu özellikleri etkinleştirmek için yeni extraComputations dizi istek parametresini ayarlayın.
  • Yanıtta bilgilerin döndürüleceğini belirtmek için bir alan maskesi ayarlayın.

Bilmeniz gerekenler:

extraComputations ayarı ile açıkça etkinleştirilmedikçe aşağıdaki alanlar artık computeRouteMatrix yanıtlarına dahil edilmeyecektir:

  • travelAdvisory.tollInfo (Gişe bilgileri)

extraComputations ayarı ile açıkça etkinleştirilmedikçe aşağıdaki alanlar artık computeRoutes yanıtlarına dahil edilmeyecektir:

  • routes.legs.travelAdvisory.tollInfo(Gişe bilgileri)
  • routes.travelAdvisory.tollInfo(Gişe bilgileri)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Yakıt tüketimi)
  • routes.travelAdvisory.speedReadingIntervals(Poli çizgi üzerinde trafik)
  • routes.legs.travelAdvisory.speedReadingIntervals(Poli çizgi üzerinde trafik)

Ne yapmanız gerekiyor?

Bir çok çizgi üzerinde geçiş ücreti bilgileri, yakıt tüketimi veya trafikle ilgili yanıt alanlarını almak için yeni istek dizisi alanını (extraComputations) aşağıdaki değerlerden en az birini içerecek şekilde ayarlamanız gerekir: