Method: isochrones.generate

Belirli bir parametre grubu için tek bir izokron hesaplar ve döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "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.
}
Alanlar
travelDuration

string (Duration format)

Zorunlu. İzokron hesaplaması için seyahat süresi. Değer pozitif olmalı ve 7.200 saniye (120 dakika) ile sınırlanmalıdır. DRIVE modunda izin verilen maksimum süre 3.600 saniye (60 dakika) olur.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
travelMode

enum (TravelMode)

Zorunlu. Ulaşım şekli.
travelDirection

enum (TravelDirection)

Zorunlu. Seyahat yönü.
routingPreference

enum (RoutingPreference)

İsteğe bağlı. Yönlendirme tercihini belirtir. Varsayılan olarak TRAFFIC_UNAWARE değerine ayarlanır.
enableSmoothing

boolean

İsteğe bağlı. Ortaya çıkan eşzamanlılık çokgenlerinin kenarlarının düzleştirilip düzleştirilmeyeceğini belirtir.
polygonFidelity

enum (PolygonFidelity)

İsteğe bağlı. Oluşturulan poligonun hassasiyetini kontrol eder. Varsayılan olarak POLYGON_FIDELITY_UNSPECIFIED değerine ayarlanır.
origin birleşik alanı. Zorunlu. İzokron hesaplaması için başlangıç noktası. origin aşağıdakilerden yalnızca biri olabilir:
location

object (LatLng)

Enlem/boylam koordinatı olarak başlangıç noktası.
place

string

Bir yerin places/{place_id} biçimindeki kaynak adı.

Yanıt metni

Oluşturulan izokron verilerini içeren bir yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "isochrone": {
    object (Isochrone)
  }
}
Alanlar
isochrone

object (Isochrone)

Yalnızca çıkış. Oluşturulan izokron.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem derecelerini ve boylam derecelerini temsil etmek için çiftler halinde ifade edilir. Aksi belirtilmediği sürece bu nesne, WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem değeri derece cinsinden olmalıdır. [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

TravelMode

Eşzamanlılık hesaplaması için ulaşım şeklini tanımlar.

Sıralamalar
TRAVEL_MODE_UNSPECIFIED Ulaşım şekli belirtilmedi.
DRIVE Binek otomobille seyahat edin.
BICYCLE Bisikletle seyahat edin.
WALK Yürüyerek seyahat etme

TravelDirection

İzokron hesaplaması için seyahat yönünü belirtir.

Sıralamalar
TRAVEL_DIRECTION_UNSPECIFIED Seyahat yönü belirtilmedi.
FROM Başlangıç noktasından ulaşılabilen alanı hesaplar. Örnek: "Depomdan 30 dakika içinde nereye teslimat yapabilirim?"
TO Başlangıç noktasına gitmek için seyahat edebileceğiniz alanı hesaplar. Örnek: "Çalışanlarım ofise 30 dakika içinde ulaşmak için nereden işe gidip gelebilir?"

RoutingPreference

Trafik koşullarının hesaplamaya nasıl dahil edileceğini belirler.

Sıralamalar
ROUTING_PREFERENCE_UNSPECIFIED Yönlendirme tercihi belirtilmedi. Sunucu, varsayılan değeri olan TRAFFIC_UNAWARE'i kullanır.
TRAFFIC_UNAWARE Hesaplamada trafik koşulları dikkate alınmaz. İzokron, yol ağına ve statik seyahat sürelerine göre belirlenir. Bu, trafiğin bir faktör olmadığı planlama amaçları için uygundur.
TRAFFIC_AWARE Hesaplamada anlık trafik koşulları dikkate alınır.

PolygonFidelity

İzokron poligonundaki ayrıntı düzeyini kontrol eder.

Sıralamalar
POLYGON_FIDELITY_UNSPECIFIED Poligon doğruluğu belirtilmemiş. Sunucu, seyahat süresine dayalı olan varsayılan değerini kullanır.
LOW Hassasiyeti düşüktür. Daha az köşe noktasıyla geniş alanları kaplamak için uygundur.
MEDIUM Orta hassasiyet. Ayrıntı ve yapay nesne boyutu arasında denge.
HIGH Yüksek hassasiyet. Yüksek doğrulukta kenarlar ancak yol ağı yoğunluğunun düşük olduğu yerlerde poligonda boşluklar oluşabilir.

Eşzamanlılık

Belirli bir seyahat süresi içinde bir başlangıç noktasından ulaşılabilirliği temsil eden bir izokron hesaplamasının sonucu.

JSON gösterimi 
{

  // Union field geometry can be only one of the following:
  "geoJson": {
    object
  }
  // End of list of possible types for union field geometry.
}
Alanlar
geometry birleşik alanı. İzokronun geometrik temsili. geometry aşağıdakilerden yalnızca biri olabilir:
geoJson

object (Struct format)

RFC 7946 biçimini kullanan GeoJSON biçimindeki eşzamanlılık eğrisi geometrisi: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.