Ö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'a tabidir. Daha fazla bilgi için lansman aşaması 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, önizlemeye dahil edilmeyen 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 konum belirtmek için aşağıdakileri kullanabilirsiniz:

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

      Adres dizeleri genellikle kullanıcının adres girme şeklidir. Bununla birlikte, {product_name} bir rota hesaplayabilmesi için önce adres dizesinin enlem/boylam koordinatlarına dönüştürülmesi için önce dahili olarak coğrafi kodlama yapması gerekir.

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

    • Artı Kodları

      Plus Code'lar, gerçek bir adresi olmayan kişilerin veya yerlerin açık adresleri gibidir. Artı Kodları, sokak adları ve numaraları olan adreslerin yerine enlem ve boylama dayanır, rakam ve harf şeklinde gösterilir.

  • İş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 ara nokta) için bir yer kimliği araması gerçekleştirir. Bu dizinin her öğesi, bir konuma karşılık gelen yer kimliğini ve konumla ilgili ek meta verileri içerir. İstekteki konumlar, yer kimliği veya enlem/boylam koordinatları olarak belirtilir.

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

Şimdi isteğe yeni dizi extraComputations 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 bilgileri döndürmeyi belirtmek için bir alan maskesi kullanıyordunuz. Artık hem şunları yapmalısınız:

  • Bu özellikleri etkinleştirmek için yeni extraComputations dizisi istek parametresini ayarlayın.
  • Yanıttaki bilgileri döndürecek bir alan maskesi ayarlayın.

Bilmeniz gerekenler

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

  • travelAdvisory.tollInfo (Ücret bilgisi)

Aşağıdaki alanlar, extraComputations ayarıyla 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 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?

Çoklu çizgide ücretli geçiş 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 bir veya daha fazlasını içerecek şekilde ayarlamanız gerekir: