Gezinme noktaları

Coğrafi kodlama yanıtındaki navigation_points alanı, yere gitmek için faydalı olan noktaların listesini içerir. Daha açık belirtmek gerekirse, bir yol ağında bir yerden başka bir yere rota çizerken bu yerler başlangıç veya bitiş noktası olarak kullanılmalıdır. Her gezinme noktası aşağıdaki değerleri içerir:

  • location, gezinme noktasının enlem ve boylam değerini içerir. Bu konum her zaman yol ağına çok yakındır ve bir yere gidip gelmek için ideal bir durak veya başlangıç noktasıdır. Nokta, yerin bulunduğu yolun tarafını net bir şekilde işaretlemek için yolun merkez çizgisinden kasıtlı olarak biraz kaydırılır.
  • restricted_travel_modes, navigasyon noktasına erişilemeyen seyahat modlarının listesidir:
    • "DRIVE", sürüş yol tariflerine karşılık gelen ulaşım şeklidir.
    • "WALK", yürüyüş yol tariflerine karşılık gelen ulaşım şeklidir.
  • road_name, gezinme noktasının ofsetlendiği yolun adını içerir.

Tam konumu olan çoğu yer (ör. sokak adresleri, binalar ve kuruluşlar) için navigasyon noktaları döndürülür. Tam konumun belirsiz olabileceği büyük alanları (ör. şehirler ve bölgeler) temsil eden yerler, herhangi bir navigasyon noktası döndürmeyebilir.

Taşıma bildirimi

17 Nisan'dan itibaren, gezinme noktaları almak için istekte NAVIGATION_POINTS extracomputations parametresini sağlamanız gerekir. Müşteriler, bazı gezinme noktalarındaki road_name alanının döndürüldüğünü ve her gezinme noktasındaki location alanının aşağıdaki dört alt alana (lat, lng, latitude, longitude) sahip olduğunu onaylayarak bunu test edebilir.

Ayrıca, location.latitude ve location.longitude alanları yerine location.lat ve location.lng alanlarına taşımanız gerekir. Gelecekteki bir sürümde, NAVIGATION_POINTS ek hesaplamalar parametresini içermeyen istekler yanıtta herhangi bir gezinme noktası içermeyecek ve location.latitude ile location.longitude alanları artık döndürülmeyecektir.

Talep ayıntıları

Gezinme noktalarını aşağıdaki istek türlerinde alabilirsiniz:

Bu isteklerin herhangi biri için şu parametreyi sağlarsınız: extra_computations=NAVIGATION_POINTS.

Örnek istek

Aşağıdaki sorgu, ABD'nin Kaliforniya eyaletinin Mountain View şehrindeki bir restoranın navigasyon noktalarını almak için yer coğrafi kodlamasını kullanır:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

Örnek yanıt

Yukarıdaki sorgudan alınan yanıtta bir dizi gezinme noktası gösterilir:

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

Geri bildirim

Bu, deneysel bir özelliktir. Geri bildirimlerinizi [email protected] adresine gönderebilirsiniz.