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

Routes API, Eylül 2022'de herkese açık Önizleme (GKST öncesi) olarak yayınlandı. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özel Şartlar kapsamındadır. 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.

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

GA sürümünde, Önizleme'de yer almayan aşağıdaki yeni özellikler eklenmiştir:

  • 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, Australia")

      Adres dizeleri genellikle kullanıcının adresi girme şeklidir. Bununla birlikte, {product_name} bir rotayı hesaplayabilmesi için öncelikle adres dizesini enlem/boylam koordinatlarına dönüştürmek üzere dahili olarak coğrafi kodlamasını yapmalıdır.

      Ayrıca, belirli bir coğrafi bölge için coğrafi kodlamalı sonuçları döndürmeyi sağlayan regionCode istek parametresi desteği de eklenmiştir.

    • Artı Kodları

      Artı Kodları, gerçek adresi olmayan kişilerin veya yerlerin açık adresleri gibidir. Plus Code'ları, sokak adları ve numaraları içeren adresler yerine enlem ve boylamı temel alır ve sayılar ile harfler şeklinde görüntülenir.

  • İşlem rotaları yanıtı artık geocodingResults dizisini içeriyor. API, adres dizesi veya artı kodu olarak belirtilen istekteki her konum (kaynak, hedef veya ara referans noktası) için bir yer kimliği araması gerçekleştirir. Bu dizinin her bir öğesi, bir konuma karşılık gelen yer kimliğini ve konumla ilgili ek meta verileri içerir. İstekte yer kimliği veya enlem/boylam koordinatları olarak belirtilen konumlar yok sayılır.

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

Şimdi 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 özelliklerle ilgili bilgilerin döndürüleceğini belirtmek için bir alan maskesi kullanıyordunuz. Artık şunları yapmalısınız:

  • Bu özellikleri etkinleştirmek için yeni extraComputations dizi isteği parametresini ayarlayın.
  • Yanıttaki bilgileri döndürmek için bir alan maskesi ayarlayın.

Bilmeniz gerekenler

extraComputations ayarlanmasıyla açıkça etkinleştirilmediği sürece aşağıdaki alanlar computeRouteMatrix yanıtlarına dahil edilmez:

  • travelAdvisory.tollInfo (Ücret bilgisi)

extraComputations ayarlandığında açıkça etkinleştirilmediği sürece aşağıdaki alanlar computeRoutes yanıtlarına dahil edilmez:

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

Ne yapmanız gerekiyor?

Bir çoklu çizgideki ücret bilgisi, yakıt tüketimi veya trafik ile ilgili yanıt alanlarını almak için yeni istek dizisi alanını (extraComputations) aşağıdaki değerlerden birini veya daha fazlasını içerecek şekilde ayarlamanız gerekir: