Method: isochrones.generate

Menghitung dan menampilkan satu isokron untuk kumpulan parameter tertentu.

Permintaan HTTP

POST https://isochrones.googleapis.com/v1/isochrones:generate

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "travelDuration": string,
  "travelMode": enum (TravelMode),
  "travelDirection": enum (TravelDirection),
  "routingPreference": enum (RoutingPreference),
  "enableSmoothing": boolean,
  "polygonFidelity": enum (PolygonFidelity),

  // Union field origin can be only one of the following:
  "location": {
    object (LatLng)
  },
  "place": string
  // End of list of possible types for union field origin.
}
Kolom
travelDuration

string (Duration format)

Wajib. Waktu perjalanan untuk perhitungan isokron. Nilai harus positif dan dibatasi hingga 7.200 detik (120 menit). Untuk mode DRIVE, durasi maksimum yang diizinkan adalah 3.600 detik (60 menit).

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
travelMode

enum (TravelMode)

Wajib. Moda transportasi.
travelDirection

enum (TravelDirection)

Wajib. Arah perjalanan.
routingPreference

enum (RoutingPreference)

Opsional. Menentukan preferensi untuk cara merutekan. Default-nya adalah TRAFFIC_UNAWARE.
enableSmoothing

boolean

Opsional. Menentukan apakah akan menghaluskan tepi poligon isokron yang dihasilkan.
polygonFidelity

enum (PolygonFidelity)

Opsional. Mengontrol presisi poligon yang dihasilkan. Default-nya adalah POLYGON_FIDELITY_UNSPECIFIED.
Kolom union origin. Wajib. Titik awal untuk perhitungan isokron. origin hanya dapat berupa salah satu dari berikut:
location

object (LatLng)

Asal sebagai koordinat lintang/bujur.
place

string

Nama resource tempat, dalam format places/{place_id}.

Isi respons

Respons yang berisi data isokron yang dihasilkan.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "isochrone": {
    object (Isochrone)
  }
}
Kolom
isochrone

object (Isochrone)

Hanya output. Isokron yang dihasilkan.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali jika ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

TravelMode

Menentukan moda transportasi untuk perhitungan isokron.

Enum
TRAVEL_MODE_UNSPECIFIED Tidak ada moda transportasi yang ditentukan.
DRIVE Perjalanan dengan mobil penumpang.
BICYCLE Perjalanan dengan sepeda.
WALK Perjalanan dengan berjalan kaki.

TravelDirection

Menentukan arah perjalanan untuk perhitungan isokron.

Enum
TRAVEL_DIRECTION_UNSPECIFIED Tidak ada arah perjalanan yang ditentukan.
FROM Menghitung area yang dapat dijangkau dari titik asal. Contoh: "Ke mana saya dapat mengirimkan barang dari gudang saya dalam waktu 30 menit?"
TO Menghitung area dari mana Anda dapat melakukan perjalanan ke titik asal. Contoh: "Dari mana karyawan saya dapat melakukan perjalanan ke kantor dalam waktu 30 menit?"

RoutingPreference

Menentukan cara kondisi lalu lintas dimasukkan ke dalam perhitungan.

Enum
ROUTING_PREFERENCE_UNSPECIFIED Tidak ada preferensi perutean yang ditentukan. Server akan menggunakan nilai default-nya, yaitu TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Perhitungan tidak akan mempertimbangkan kondisi lalu lintas. Isokron akan didasarkan pada jaringan jalan dan waktu perjalanan statis. Hal ini cocok untuk tujuan perencanaan jika lalu lintas bukan merupakan faktor.
TRAFFIC_AWARE Perhitungan akan mempertimbangkan kondisi lalu lintas langsung.

PolygonFidelity

Mengontrol tingkat detail dalam poligon isokron.

Enum
POLYGON_FIDELITY_UNSPECIFIED Tidak ada fidelitas poligon yang ditentukan. Server akan menggunakan nilai default-nya, yang didasarkan pada durasi perjalanan.
LOW Presisi rendah. Baik untuk mencakup area yang luas dengan lebih sedikit verteks.
MEDIUM Presisi sedang. Keseimbangan antara detail dan ukuran artefak.
HIGH Presisi tinggi. Tepi fidelitas tinggi, tetapi dapat menghasilkan lubang dalam poligon jika kepadatan jaringan jalan rendah.

Isochrone

Hasil perhitungan isokron, yang mewakili area jangkauan dari titik asal dalam waktu perjalanan yang ditentukan.

Representasi JSON 
{

  // Union field geometry can be only one of the following:
  "geoJson": {
    object
  }
  // End of list of possible types for union field geometry.
}
Kolom
Kolom union geometry. Representasi geometris isokron. geometry hanya dapat berupa salah satu dari berikut:
geoJson

object (Struct format)

Geometri isokron dalam format GeoJSON, menggunakan format RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.