Daha yüksek doğrulukla coğrafi kodlama

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

GeocodeAddress ve SearchDestinations yöntemleri, yanıt gecikmesi ile adres çözümleme doğruluğu arasındaki dengeyi kontrol etmenizi sağlayan isteğe bağlı bir effort parametresini destekler.

Standart coğrafi kodlama, iyi biçimlendirilmiş posta adreslerini bir saniyeden kısa gecikme süresiyle işlerken gerçek dünyadaki girişler genellikle eksik, resmi olmayan veya karmaşıktır (ör. "Flat 4B, Sunrise Apartments, opposite Central Mall, Andheri West, Mumbai" veya "where the warriors play, sf"). Daha yüksek bir effort düzeyi yapılandırarak Geocoding API'ye, zor adresleri çözmek için genişletilmiş akıl yürütme ve anlam belirsizliğini giderme yöntemlerini uygulamasını söyleyebilirsiniz.

Çaba düzeyleri

effort parametresi için aşağıdaki değerlerden birini belirtin:

Çaba düzeyi Açıklama Tipik gecikme Önerilen kullanım alanları
EFFORT_UNSPECIFIED Varsayılan değer. LOW çaba ile aynı şekilde davranır. Saniyenin altında Varsayılan standart coğrafi kodlama.
LOW En hızlı yanıt süreleri için optimizasyon sağlar. Zor adresler için kapsamlı arama veya anlam belirsizliğini giderme işlemi yapmaz. Saniyenin altında Gerçek zamanlı etkileşimli arama, yüksek hacimli standart adres doğrulama.
MEDIUM Hız ve doğruluk arasında denge kurar. Çoğu istek standart düşük gecikmeyle döndürülür. Belirsiz veya zor adresler için hizmet, doğruluğu artırmak amacıyla ek işlemler uygular. Bu işlemler birkaç saniye sürebilir. Standart adresler için bir saniyeden kısa; belirsiz adresler için birkaç saniyeye kadar (≤ 4 saniye) Kullanıcıların kısa bir duraklamayı tolere edebileceği etkileşimli kullanıcı iş akışları (ör. ödeme sırasında adres onayı).
HIGH Eksik, resmi olmayan veya karmaşık adresler için adres çözümleme doğruluğunu en üst düzeye çıkarır. Yanıt süreleri önemli ölçüde daha uzun olabilir. Karmaşık adresler için 20 saniyeye kadar Arka planda işleme, toplu coğrafi kodlama, lojistik sevkiyat veya ödeme sonrası eşzamansız adres iyileştirme.

İstek örnekleri

Varış noktası arama (SearchDestinations)

https://geocode.googleapis.com/v4alpha/geocode/destinations adresine gönderdiğiniz POST isteğinizin JSON istek gövdesine effort alanını ekleyin. effort parametresi öncelikle addressQuery çözünürlüğünü etkiler:

curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "Flat 4B, Sunrise Apartments, opposite Central Mall, Andheri West, Mumbai"
  },
  "effort": "HIGH"
}' \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4alpha/geocode/destinations

Bir adresi coğrafi olarak kodlama (GeocodeAddress)

effort parametresini, /v4alpha/ uç noktasına gönderdiğiniz GET isteğinde URL sorgu parametresi olarak iletin:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
"https://geocode.googleapis.com/v4alpha/geocode/address/where+the+warriors+play,+sf?effort=MEDIUM"

Gecikme süresinin etkisini azaltma

Uygulamanızda MEDIUM veya HIGH çaba düzeyini kullanırken tek adımlı istek göndermek en basit entegrasyon yöntemidir. Ancak bu modlardaki istekler daha yüksek gecikmeye neden olabilir. Bu da kullanıcıya yönelik, gecikmeye duyarlı ve eşzamanlı iş akışlarını geciktirebilir.

Bu gecikmenin etkileşimli kullanıcı işlemleri akışları (ör. ödeme veya rezervasyon) üzerindeki etkisini azaltmak için çok aşamalı bir iş akışı kullanabilirsiniz:

  1. 1. Aşama (Etkileşimli): Adresi bir saniyeden kısa bir gecikmeyle hemen doğrulamak için effort=LOW (veya varsayılan) ile senkronize bir istek gönderin.
  2. 2. Aşama (Arka Plan): Karmaşık adresleri yüksek hassasiyetli koordinatlara, girişlere ve navigasyon noktalarına dönüştürmek için effort=MEDIUM veya effort=HIGH ile eşzamansız bir takip isteği gönderin (ör. ödeme sonrasında veya sevkiyattan önce). Bu sayede kullanıcıyı engellemeden işlemi tamamlayabilirsiniz.

Kullanım sınırları

Deneysel (v4alpha) lansman aşamasında, effort değeri MEDIUM veya HIGH olarak ayarlanmış istekler, standart (LOW) isteklere göre daha katı sıklık sınırlarına tabidir. Uygulamanız bu sıklık sınırlarını aşarsa API, RESOURCE_EXHAUSTED (HTTP 429) hatası döndürür. HTTP 429 hatalarıyla karşılaşırsanız veya kullanım alanınız için daha yüksek kota gerekiyorsa geri bildirim kanalı üzerinden bizimle iletişime geçin.

Geri bildirim

Bu, Geocoding API'nin deneysel bir özelliğidir. Geri bildirimlerinizi geocoding-feedback-channel@google.com adresine gönderebilirsiniz.