Menghitung ringkasan perutean

Untuk menggunakan Text Search (Baru) atau Nearby Search (Baru) guna menghitung durasi perjalanan dan jarak ke setiap tempat dalam respons:

1. Teruskan parameter routingParameters.origin dalam permintaan untuk menentukan koordinat lintang dan bujur asal pemilihan rute. Parameter ini diperlukan untuk menghitung durasi dan jarak ke setiap tempat dalam respons.

2. Sertakan routingSummaries dalam mask kolom sehingga respons menyertakan array routingSummaries. Array ini berisi durasi dan jarak dari asal perutean ke setiap tempat dalam respons.

   Catatan: Menambahkan routingSummaries di mask kolom tanpa menyertakan parameter routingParameters.origin atau parameter searchAlongRouteParameters.polyline.encodedPolyline dalam permintaan akan menyebabkan error.

API Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat memahami API dan opsi API:

Cobalah!

Menggunakan Text Search (Baru)

Dalam permintaan berikut, Anda menghitung durasi perjalanan dan jarak ke setiap tempat dalam respons Text Search (Baru):

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'

Respons berisi dua array JSON: array places berisi tempat yang cocok, dan array routingSummaries berisi durasi dan jarak perjalanan ke setiap tempat:

{
  "places": [
    {
      object (Place)
    }
  ]
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
}

Setiap elemen dalam array routingSummaries berada di lokasi array yang sesuai sebagai tempat dalam array places. Artinya, elemen di routingSummaries[0] sesuai dengan tempat di places[0].

Panjang array routingSummaries sama dengan panjang array places. Jika routingSummary untuk suatu tempat tidak tersedia, entri array akan kosong.

Karena contoh ini menghitung durasi dan jarak dari asal perutean ke setiap tempat, kolom routingSummaries.legs dalam respons berisi satu objek Leg yang berisi duration dan distanceMeters dari asal perutean ke tempat.

Catatan: Respons ini juga menyertakan kolom directionsUri Pratinjau (pra-GA) dalam ringkasan pemilihan rute untuk setiap tempat. Kolom ini berisi link untuk membuka rute ke tempat di Google Maps. Parameter routingParameters.origin digunakan sebagai asal rute, lokasi tempat digunakan sebagai tujuan, dan mode perjalanan default-nya adalah mengemudi.

Produk atau fitur ini ada dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

{
  "places": [
    {
      "formattedAddress": "1, Westfield Sydney Central Plaza, 450 George St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Gözleme King Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    …
  ]
  "routingSummaries": [
    {
      "legs": [
        {
          "duration": "597s",
          "distanceMeters": 2607
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3fa97cd745:0x6aecf365bf497c08!3e0"
    },
    {
      "legs": [
        {
          "duration": "562s",
          "distanceMeters": 2345
        }
      ],
      "directionsUri": "https://www.google.com/maps/dir/-33.8688,151.1957362/''/data=!4m6!4m5!1m0!1m2!1m1!1s0x6b12ae3da97f60c1:0x845f3273bd764f6c!3e0"
    },
   …
  ]
}

Dari contoh ini, Anda dapat melihat bahwa durasi dan jarak dari asal rute ke tempat pertama dalam hasil adalah 597 detik dan 2.607 meter.

Menggunakan Nearby Search

Dalam contoh ini, Anda menghitung durasi perjalanan dan jarak ke setiap tempat dalam respons Penelusuran Langsung. Contoh ini menelusuri restoran di Sydney, Australia, dan menetapkan batasan lokasi serta asal pemilihan rute ke koordinat lintang dan bujur yang sama:

  curl -X POST -d '{
    "includedTypes": ["restaurant"],
    "maxResultCount": 10,
    "locationRestriction": {
      "circle": {
        "center": {
          "latitude": -33.8688,
          "longitude": 151.1957362},
        "radius": 500.0
      }
    },
    "routingParameters": {
      "origin": {
        "latitude": -33.8688,
        "longitude": 151.1957362
      }
    }
  }' \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key:API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,routingSummaries" \
  https://places.googleapis.com/v1/places:searchNearby

Anda tidak harus menggunakan koordinat yang sama untuk locationRestriction dan untuk origin pemilihan rute. Misalnya, Anda menetapkan locationRestriction ke titik tengah Sydney untuk membiaskan hasil penelusuran ke lingkaran tersebut. Namun, Anda kemudian menetapkan asal pemilihan rute ke koordinat rumah Anda, yang berarti ke lokasi lain dalam lingkaran penelusuran. Permintaan tersebut kemudian membiaskan hasil penelusuran ke lingkaran, dan menghitung ringkasan pemilihan rute berdasarkan lokasi rumah Anda.

Menentukan opsi perjalanan

Secara default, perhitungan durasi dan jarak adalah untuk mobil. Namun, Anda dapat mengontrol jenis kendaraan, serta opsi lainnya, dalam penelusuran.

• Gunakan parameter routingParameters.travelMode untuk menetapkan mode transportasi ke DRIVE, BICYCLE, WALK, atau TWO_WHEELER. Untuk mengetahui informasi selengkapnya tentang opsi ini, lihat Jenis kendaraan yang tersedia untuk rute.

  Catatan: Routes API juga mendukung mode TRANSIT, tetapi mode tersebut tidak didukung oleh Places API.
  Catatan: Opsi TWO_WHEELER hanya didukung di negara yang tercantum di Negara dan wilayah yang didukung untuk kendaraan roda dua.
• Gunakan properti routingParameters.routingPreference untuk menetapkan opsi preferensi pemilihan rute ke TRAFFIC_UNAWARE (default), TRAFFIC_AWARE, atau TRAFFIC_AWARE_OPTIMAL. Setiap opsi memiliki tingkat kualitas dan latensi data yang bervariasi. Untuk mengetahui informasi selengkapnya, lihat Menentukan cara dan apakah akan menyertakan data traffic.

  Properti routingParameters.routingPreference memengaruhi rute yang terdapat di kolom directionsUri Pratinjau (Pra-GA) karena Google Maps menampilkan opsi lalu lintas saat membuka link.

• Gunakan properti routingParameters.routeModifiers untuk menentukan ke avoidTolls, avoidHighways, avoidFerries, dan avoidIndoor. Untuk mengetahui informasi selengkapnya tentang opsi ini, lihat Menentukan fitur rute yang akan dihindari.

Pada contoh berikutnya, Anda menentukan mode perjalanan sebagai DRIVE dan untuk menghindari jalan tol:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "routingParameters": {
    "origin": {
      "latitude": -33.8688,
      "longitude": 151.1957362
    },
    "travelMode":"DRIVE",
    "routeModifiers": {
      "avoidHighways": true
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,routingSummaries' \
'https://places.googleapis.com/v1/places:searchText'