Bermigrasi dari rilis Pratinjau

Developer Wilayah Ekonomi Eropa (EEA)

Routes API dirilis sebagai Pratinjau publik (pra-GA) pada September 2022. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform Terms. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Bagian ini menjelaskan cara memigrasikan aplikasi dari rilis Pratinjau ke rilis GA.

Fitur baru yang ditambahkan ke rilis GA

Rilis GA menambahkan fitur baru berikut yang tidak disertakan dalam Pratinjau:

  • Selain ID tempat dan koordinat lintang/bujur, kini Anda dapat menentukan lokasi dalam rilis GA menggunakan:

    • String alamat ("Chicago, IL" atau "Darwin, NT, Australia")

      String alamat sering kali digunakan pengguna untuk memasukkan alamat. Namun, {product_name} harus melakukan geocoding string alamat secara internal terlebih dahulu untuk mengonversinya menjadi koordinat lintang/bujur sebelum dapat menghitung rute.

      Selain itu, dukungan untuk parameter permintaan regionCode telah ditambahkan, yang memungkinkan Anda menentukan untuk menampilkan hasil geocoding untuk wilayah geografis tertentu.

    • Plus Codes

      Plus Codes berfungsi seperti alamat untuk orang atau tempat yang tidak memiliki alamat sebenarnya. Daripada alamat dengan nama jalan dan nomor, Plus Codes didasarkan pada lintang dan bujur, serta ditampilkan sebagai angka dan huruf.

  • Respons hitung rute kini berisi array geocodingResults. Untuk setiap lokasi dalam permintaan (asal, tujuan, atau titik jalan perantara) yang ditentukan sebagai string alamat atau sebagai Kode Plus, API akan melakukan pencarian ID tempat. Setiap elemen array ini berisi ID tempat yang sesuai dengan lokasi beserta metadata tambahan tentang lokasi tersebut. Lokasi dalam permintaan yang ditentukan sebagai ID tempat atau sebagai koordinat lintang/bujur akan diabaikan.

Perubahan pada fitur Pratinjau yang ada

Anda kini harus mengaktifkan fitur berikut secara eksplisit di GA dengan menambahkan kolom array baru extraComputations ke permintaan:

Dalam rilis Pratinjau, Anda menggunakan mask kolom untuk menentukan informasi yang akan ditampilkan untuk fitur ini dalam respons. Sekarang, Anda harus:

  • Menetapkan parameter permintaan array extraComputations baru untuk mengaktifkan fitur ini.
  • Menetapkan mask kolom untuk menentukan informasi yang akan ditampilkan dalam respons.

Apa yang perlu saya ketahui?

Kolom berikut tidak akan lagi disertakan dalam respons computeRouteMatrix kecuali jika diaktifkan secara eksplisit dengan menetapkan extraComputations:

  • travelAdvisory.tollInfo (Info tol)

Kolom berikut tidak akan lagi disertakan dalam respons computeRoutes kecuali jika diaktifkan secara eksplisit dengan menetapkan extraComputations:

  • routes.legs.travelAdvisory.tollInfo(Info tol)
  • routes.travelAdvisory.tollInfo(Info tol)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Konsumsi bahan bakar)
  • routes.travelAdvisory.speedReadingIntervals(Lalu lintas di polyline)
  • routes.legs.travelAdvisory.speedReadingIntervals(Lalu lintas di polyline)

Apa yang harus saya lakukan?

Untuk menerima kolom respons untuk info tol, konsumsi bahan bakar, atau lalu lintas di polyline, Anda harus menetapkan kolom array permintaan baru, extraComputations, untuk menyertakan satu atau beberapa nilai berikut:

  • Untuk menerima info tol, tetapkan kolom array baru extraComputations ke "TOLLS".

  • Untuk menerima konsumsi bahan bakar, tetapkan extraComputations kolom array baru ke "FUEL_CONSUMPTION".

  • Untuk menerima informasi lalu lintas di polyline, tetapkan kolom array extraComputations baru ke "TRAFFIC_ON_POLYLINE".