Rota için konum belirtme

Bir rotayı hesaplamak için en azından rotanın konumlarını belirtmeniz gerekir kalkış ve rota varış noktası. Bu konumları Search Ads 360'ta ara nokta olarak yol gösterir.

Kalkış ve varış noktalarına ek olarak ve bir rota için ara noktaların nasıl işleneceği. Daha fazla bilgi edinmek ve aşağıdaki konulara bakın:

Rota için konum belirtme

Bir ara nokta (REST) oluşturarak bir konumu temsil edersiniz veya Waypoint (gRPC) nesnesinin bir örneğidir. bir konumu şu yöntemlerden biriyle belirtebilirsiniz:

Bir istekteki tüm ara noktalar için konumları aynı şekilde belirtebilirsiniz. ya da bunları karıştırabilirsiniz. Örneğin, her bir konum için enlem/boylam koordinatlarını başlangıç ara noktasını ve hedef ara nokta olarak bir yer kimliği kullanın.

Verimlilik ve doğruluk için enlem/boylam yerine yer kimliklerini kullanın koordinatlara veya adres dizelerine sahip olmalıdır. Yer kimlikleri benzersiz biçimde müstehcendir ve yönlendirme için coğrafi kodlama avantajlarını (ör. erişim noktaları ve trafik değişkenleri) ele aldık. Onlar aşağıdaki durumlardan kaçınmanıza yardımcı olur: Bir konum belirterek:

  • Enlem/boylam koordinatlarının kullanılması, konumun bu koordinatlara en yakın yola sabitlenir - bu da hızlı veya güvenli bir şekilde geçen bir yol üzerinde bile onları da hedefe yönlendirir.
  • Dönüştürme işlemi için adres dizelerinin önce Routes API tarafından coğrafi kodlaması yapılmalıdır bir rota hesaplayabilmesi için enlem/boylam koordinatlarına değiştirmelidir. Bu dönüşüm, performansı etkileyebilir.

Yer kimliği olarak bir konum belirtin

Bir referans noktasının konumunu belirtmek için yer kimliği kullanabilirsiniz. Çünkü enlem ve boylam koordinatları yollara sabitlenirse, yer kimliği bazı durumlarda daha iyi sonuçlar verir.

Geocoding API'den yer kimliklerini alın ve Places API'yi (Yer dahil) Otomatik tamamlama). Yer kimlikleri hakkında daha fazla bilgi için bkz. Yer kimliğine genel bakış.

Aşağıdaki örnekte, her ikisi için de yer kimliği iletmek amacıyla placeId özelliği kullanılmaktadır. origin ve destination:

{
  "origin":{
    "placeId": "ChIJayOTViHY5okRRoq2kGnGg8o"
  },
  "destination":{
    "placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU"
  },
  ...
}

Enlem ve boylam koordinatları olarak bir yer belirtme

Bir ara nokta olarak konumu tanımlamak için, Konum (REST) veya Konum(gRPC) işlevini kullanarak enlem/boylam koordinatları.

Örneğin, origin ve destination rotası için bir ara nokta belirtin latitude ve longitude koordinatları kullanılarak:

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
...
}

Adres dizesi olarak bir konum belirtme

Adres dizeleri, bir dizeyle temsil edilen düz adreslerdir (ör. "1600 Amphitheatre Parkway, Mountain View, CA"). Coğrafi kodlama, bir adres dizesini enlem ve boylam koordinatlarına (ör. enlem 37.423021 ve boylam -122.083739).

Referans noktasının konumu olarak bir adres dizesi ilettiğinizde Routes API dizeyi enlem ve boylama dönüştürmek için dahili olarak coğrafi kodlama yapar koordinatlar.

Örneğin, bir rotayı hesaplamak için origin rotası için bir ara nokta ve destination adres dizelerini kullanıyor:

{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "450 Serra Mall, Stanford, CA 94305, USA"
  },
  ...
}

Bu örnekte, Routes API iki adresi de enlem ve boylam koordinatları.

Adres değeri belirsizse Routes API, bir benzer adreslerden netleştirmelerine olanak tanır. Örneğin, "1. Cadde" bir tam değer veya "1. sokak KD" için kısmi bir değer veya "1st St SE". Bu sonuç, Geocoding API tarafından döndürülen sonuçlardan farklı olabilir. Önerebileceğiniz işlemler olası yanlış yorumlamalardan bahsedeceğiz.

Adresin bölgesini ayarlama

Bir referans noktasının konumu olarak eksik bir adres dizesi iletirseniz API, coğrafi olarak kodlanan yanlış enlem/boylam koordinatlarını kullanabilir. Örneğin, "Toledo" belirten bir istek gönderirsiniz olarak "Madrid"i olarak sürüş rotası için hedef:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE"
}

Bu örnekte, "Toledo" şu eyalette bir şehir olarak yorumlanır: ABD'de Ohio, İspanya'da değil. Dolayısıyla, istek boş bir dizidir; yani hiç rota yoktur:

{
  []
}

API'yi belirli bir bölgeye göre ağırlıklandırılmış sonuçlar döndürecek şekilde yapılandırarak dahil olmak üzere regionCode parametresini içerir. Bu parametre, bölge kodunu ccTLD ("üst düzey alan") iki karakterlik değer. Çoğu ccTLD kodu, ISO 3166-1 kodlarıyla aynıdır; ancak bazı önemli istisnaları var. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" olur (.co.uk), ISO 3166-1 kodu "gb" ise (teknik olarak " Büyük Britanya ve Kuzey İrlanda Birleşik Krallık'ı").

"Toledo" için yol tarifi isteği "Madrid"e regionCode içerir parametresi uygun sonuçlar döndürdüğünden, "Toledo" şu şekilde yorumlanır: İspanya'da şehir:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE",
  "regionCode": "es"
}

Yanıt artık Toledo, İspanya'dan Toledo'ya Madrid, İspanya:

{
  "routes": [
    {
      "distanceMeters": 75330,
      "duration": "4137s",
      ...
    }
  ]
}

Plus Code olarak bir konum belirtin

Birçok kişinin tam adresi olmadığından ulaşabilmeleri zor olabilir teslimat almayı kabul etti. Veya adresi olan kişiler Arka giriş veya yükleme gibi daha belirli konumlarda yapılan teslimatlar yuvaya yerleştirin.

Plus Code'lar, gerçek adres. Sokak isimleri ve numaraları olan adresler yerine Plus Code'lar enlem/boylam koordinatlarına dayanır ve rakamlar ile anlamına gelir.

Google, Plus Code'ları geliştirdi. herkese ve her şeye adres avantajını sunmayı başardı. Plus Code, kodlanmış bir enlem/boylam koordinatlarından elde edilen, bir alanı ifade eder: derecenin 1/8.000'i x 1/8.000'i (yaklaşık 14 m x) ekvatorda 14 m) veya daha kısa olmalıdır. Plus Code'ları şunun yerine kullanabilirsiniz: mevcut olmadıkları veya binaların olmadığı yerlerde açık adresler veya sokaklar adlandırılmamış.

Plus Code'lar global kod veya bileşik kod olarak biçimlendirilmelidir:

  • Genel kod, 4 karakterli alan kodundan ve 6 karakterden oluşur. karakter veya daha uzun yerel kod.

    Örneğin, "1600 Amphitheatre Parkway, Mountain View, CA", global kod: "849V" ve yerel kod "CWC8+R9". Daha sonra, 10 karakterlik Plus Code'un tamamını kullanarak konum değerini "849VCWC8+R9" olarak ayarlayın.

  • Bileşik kod, 6 veya daha uzun bir karakterden oluşur. yerel kod açık bir konumla birleştirilir.

    Örneğin, "450 serra" adresi Mall, Stanford, CA 94305, ABD" yerel kodu "CRHJ+C3"tür. Bileşik için adres, yerel kodu şehir, eyalet, posta kodu ve ülke ile birleştirin kısmına "CRHJ+C3 Stanford, CA 94305, ABD" biçiminde yazılır.

    Örneğin, origin rotası için bir ara nokta belirterek rota hesaplayın. ve destination Plus Code'ları kullanıyor:

    {
  "origin":{
    "address": "849VCWC8+R9"
  },
  "destination":{
    "address": "CRHJ+C3 Stanford, CA 94305, USA"
  },
  "travelMode": "DRIVE"
}

Plus Code'lar aşağıdakiler gibi Google Haritalar Platformu API'lerinde desteklenir: Yer Otomatik Tamamlama, Yer Ayrıntıları, Directions API ve Geocoding API. Örneğin, bir coğrafi kodlamayı tersine çevirmek için Geocoding API'yi belirlemek için enlem/boylam koordinatlarıyla belirtilen konum konumun Plus Code'u.