Package google.maps.addressvalidation.v1

Dizin

AddressValidation

Adresleri doğrulayan hizmet.

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Doğrulama denemelerinin sonucuyla ilgili geri bildirim. Bu, aynı adres için yapılan bir dizi doğrulama çağrısından sonra yapılan son çağrı olmalı ve işlem tamamlandıktan sonra çağrılmalıdır. Bu e-posta, bir adresin tam olarak doğrulanması için gereken ValidateAddress istek dizisi için yalnızca bir kez gönderilmelidir.

ValidateAddress

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

Bir adresi doğrular.

Adres

İşlenen adresin ayrıntıları. İşleme sonrası, adresin yanlış yazılan kısımlarının düzeltilmesi, yanlış kısımların değiştirilmesi ve eksik kısımların tahmin edilmesi işlemlerini içerir.

Alanlar
formatted_address

string

Sonradan işlenmiş adres; adresin bulunduğu bölgenin adres biçimlendirme kurallarına göre tek satırlık bir adres olarak biçimlendirilmiştir.

Not: Bu adresin biçimi, postal_address alanındaki adresin biçimiyle eşleşmeyebilir. Örneğin postal_address, ülkeyi her zaman 2 harfli region_code şeklinde temsil eder (ör. "US" veya "NZ"). Buna karşılık, bu alanda "ABD" veya "Yeni Zelanda" gibi daha uzun bir ülke adı biçimi kullanılır.

postal_address

PostalAddress

Posta adresi olarak temsil edilen, son işleme tabi tutulan adres.

address_components[]

AddressComponent

Sırasız liste. Biçimlendirilmiş ve düzeltilmiş adresin doğrulama bilgileriyle birlikte tek tek adres bileşenleri. Bu sayfada, bileşenlerin doğrulama durumu hakkında bilgi verilir.

Adres bileşenleri belirli bir şekilde sıralanmamalıdır. Listede adres bileşenlerinin sıralaması hakkında herhangi bir varsayımda bulunmayın.

missing_component_types[]

string

Doğru biçimlendirilmiş bir posta adresinde bulunması beklenen ancak girişte bulunmayan VE çıkarılamayan bileşen türleri. Bu tür bileşenler formatted_address, postal_address veya address_components içinde mevcut değildir. Örneğin, "Boulder, Colorado, 80301, ABD" gibi bir giriş için ['street_number', 'route'] kullanılabilir. Olası türlerin listesini burada bulabilirsiniz.

unconfirmed_component_types[]

string

address_components dosyasında bulunan ancak doğruluğu onaylanamayan bileşen türleri. Bu alan kolaylık sağlamak için sağlanmıştır: İçeriği, confirmation_level'un CONFIRMED olmadığı veya inferred işaretinin true olarak ayarlanmadığı tüm bileşenlerin türlerini bulmak için address_components içinde iterasyon gerçekleştirmekle aynıdır. Olası türlerin listesini burada bulabilirsiniz.

unresolved_tokens[]

string

Girişteki çözülemeyen jetonlar. Bu, bir adresin geçerli bir parçası olarak tanınmayan bir giriş olabilir. Örneğin, "Parsel 0000123123 ve 0000456456 Cadde # Guthrie Center IA 50115 ABD" gibi bir giriş için çözülmemiş jetonlar ["Parcel", "0000123123", "&", "0000456456"] gibi görünebilir.

AddressComponent

Sokak, şehir veya eyalet gibi bir adres bileşenini temsil eder.

Alanlar
component_name

ComponentName

Bu bileşenin adı.

component_type

string

Adres bileşeninin türü. Olası türlerin listesi için Tablo 2: Yerler hizmeti tarafından döndürülen ek türler bölümüne bakın.

confirmation_level

ConfirmationLevel

Bileşenin doğru olduğundan emin olduğumuz kesinlik düzeyini gösterir.

inferred

bool

Bileşenin girişin bir parçası olmadığını ancak adres konumu için tahmin edildiğini ve tam bir adres için sağlanmasının gerektiğini gösterir.

spell_corrected

bool

Bileşen adındaki bir yazım hatasının düzeltilmesini gösterir. API, her zaman bir yazım varyantından diğerine yapılan değişiklikleri işaretlemez (ör. "centre" yerine "center"). Ayrıca, "Amphitheater Pkwy"nin "Amphitheatre Pkwy" olarak değiştirilmesi gibi yaygın yazım hatalarını her zaman işaretlemez.

replaced

bool

Bileşen adının tamamen farklı bir adla değiştirildiğini belirtir (örneğin, adres için doğru olan bir posta kodunun yerini alması). Bu, görünümle ilgili bir değişiklik değildir. Giriş bileşeni farklı bir bileşenle değiştirilmiştir.

unexpected

bool

Belirli bir bölgenin posta adresinde bulunması beklenmeyen bir adres bileşenini belirtir. Bunu yalnızca girişin bir parçası olduğu için sakladık.

ConfirmationLevel

Onay düzeyleri için olası farklı değerler.

Sıralamalar
CONFIRMATION_LEVEL_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
CONFIRMED Bu bileşenin mevcut olduğunu ve adresin geri kalanıyla uyumlu olduğunu doğrulayabildik.
UNCONFIRMED_BUT_PLAUSIBLE Bu bileşen doğrulanamadı ancak var olduğu varsayılabilir. Örneğin, belirli ev numaralarının bilinmediği bir sokaktaki bilinen geçerli numara aralığında yer alan sokak numarası.
UNCONFIRMED_AND_SUSPICIOUS Bu bileşen onaylanmadı ve yanlış olması muhtemel. Örneğin, adresin geri kalanına uymayan bir mahalle.

AddressMetadata

Adresin meta verileri. metadata değerinin, Address Validation API'ye gönderilen her adres için tam olarak doldurulacağı garanti edilmez.

Alanlar
business

bool

Bunun bir işletmenin adresi olduğunu belirtir. Ayarlanmadan bırakılırsa değerin bilinmediğini belirtir.

po_box

bool

Adresin posta kutusuna ait olduğunu belirtir. Ayarlanmamışsa değerin bilinmediğini gösterir.

residential

bool

Bu adresin bir konutun adresini belirtir. Ayarlanmamışsa değerin bilinmediğini gösterir.

ComponentName

Bileşenin adı için bir sarmalayıcı.

Alanlar
text

string

Ad metni. Örneğin, sokak adı için "5. Cadde" veya bina numarası için "1253".

language_code

string

BCP-47 dil kodu. Bileşen adı bir dil (ör. bina numarası) ile ilişkilendirilmemişse bu alan gösterilmez.

Coğrafi kod

Girişin coğrafi kodlandığı yerle ilgili bilgileri içerir.

Alanlar
location

LatLng

Girişin coğrafi kodlanmış konumu.

Adresler, enlem/boylam koordinatları veya plus code'lar yerine yer kimlikleri kullanılması tercih edilir. Güzergah belirleme veya sürüş yol tariflerini hesaplarken koordinatların kullanılması, her zaman, noktanın söz konusu koordinatlara en yakın yola tutturulmasını sağlar. Bu yol, hedefe hızlı veya güvenli bir şekilde ulaşacak bir yol olmayabilir ve mülke erişim noktasına yakın bir yerde olmayabilir. Ayrıca, bir konum ters coğrafi kodlandığında döndürülen adresin orijinal adresle eşleşeceği garanti edilmez.

plus_code

PlusCode

location değerine karşılık gelen plus code.

bounds

Viewport

Coğrafi olarak kodlanmış yerin sınırları.

feature_size_meters

float

Coğrafi kodlu yerin metre cinsinden boyutu. Bu, coğrafi kodlanmış konumun kabalığının başka bir ölçümüdür ancak semantik anlam yerine fiziksel boyuttadır.

place_id

string

Bu girişin coğrafi kodladığı yerin PlaceID'si.

Yer kimlikleri hakkında daha fazla bilgiyi burada bulabilirsiniz.

place_types[]

string

Girişin coğrafi olarak kodlandığı yer türleri. Örneğin, ['locality', 'political']. Türlerin tam listesini burada bulabilirsiniz.

LanguageOptions

Önizleme: Bu özellik önizleme sürümündedir (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Address Validation API'nin yanıta ek bilgiler eklemesini sağlar.

Alanlar
return_english_latin_address

bool

Önizleme: İngilizce bir google.maps.addressvalidation.v1.Address döndürür. Ayrıntılar için google.maps.addressvalidation.v1.ValidationResult.english_latin_address sayfasına bakın.

PlusCode

Plus code (http://plus.codes), iki biçime sahip bir konum referansı: 14 m x 14 m (derecenin 1/8000'i) veya daha küçük bir dikdörtgeni tanımlayan genel kod ve ön eki referans konumla değiştiren birleşik kod.

Alanlar
global_code

string

"9FWM33GV+HQ" gibi yerin küresel (tam) kodu. 1/8000 ile 1/8000 derecelik bir alanı (~14x14 metre) temsil eder.

compound_code

string

Yerin birleşik kodu ("33GV+HQ, Ramberg, Norveç" gibi). Bu kod, genel kodun son ekini içerir ve ön eki, referans öğenin biçimlendirilmiş adıyla değiştirir.

ProvideValidationFeedbackRequest

Doğrulama geri bildirimi gönderme isteği.

Alanlar
conclusion

ValidationConclusion

Zorunlu. Doğrulama denemelerinin sonucu.

Bu alan VALIDATION_CONCLUSION_UNSPECIFIED olarak ayarlanırsa INVALID_ARGUMENT hatası döndürülür.

response_id

string

Zorunlu. Bu geri bildirimin gönderildiği yanıtın kimliği. Bu, bir dizi adres doğrulama denemesinde ilk yanıttaki [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] olmalıdır.

ValidationConclusion

Bir adresi doğrulamak için gereken adres doğrulama isteği dizisinin olası nihai sonuçları.

Sıralamalar
VALIDATION_CONCLUSION_UNSPECIFIED Bu değer kullanılmamaktadır. ProvideValidationFeedbackRequest.conclusion alanı VALIDATION_CONCLUSION_UNSPECIFIED olarak ayarlanırsa INVALID_ARGUMENT hatası döndürülür.
VALIDATED_VERSION_USED İşlem için Address Validation API tarafından döndürülen adresin sürümü kullanıldı.
USER_VERSION_USED İşlem için kullanıcı tarafından sağlanan adresin sürümü kullanıldı
UNVALIDATED_VERSION_USED Adresin, son doğrulama denemesinden sonra girilen ancak yeniden doğrulanmamış bir sürümü işlem için kullanıldı.
UNUSED İşlem iptal edildi ve adres kullanılmadı.

ProvideValidationFeedbackResponse

Bu türde alan yoktur.

Doğrulama geri bildiriminin yanıtı.

Geri bildirim başarıyla gönderilirse yanıt boş olur.

UspsAddress

ABD adresinin USPS temsili.

Alanlar
first_address_line

string

İlk adres satırı.

firm

string

Firma adı.

second_address_line

string

İkinci adres satırı.

urbanization

string

Porto Riko'daki kentleşmenin adı.

city_state_zip_address_line

string

Şehir + eyalet + posta kodu.

city

string

Şehir adı.

state

string

2 harfli durum kodudur.

zip_code

string

Posta kodu ör. 10009.

zip_code_extension

string

4 haneli posta kodu uzantısı (ör. 5023).

UspsData

Adresin USPS verileri. Address Validation API'ye gönderilen her ABD veya PR adresi için uspsData değerinin tam olarak doldurulacağı garanti edilmez. Yanıtın birincil kısmı olarak uspsData öğesini kullanıyorsanız yedek adres alanlarını yanıta entegre etmeniz önerilir.

Alanlar
standardized_address

UspsAddress

USPS standartlaştırılmış adresi.

delivery_point_code

string

2 haneli teslimat noktası kodu

delivery_point_check_digit

string

Teslimat noktası kontrol basamağı. Bu numara, mekanik olarak taranan posta için delivery_point_barcode değerinin sonuna eklenir. delivery_point_barcode, delivery_point_check_digit, postal_code ve ZIP+4 değerlerinin tüm basamakları birlikte eklendiğinde 10'a bölünebilen bir sayı elde edilmelidir.

dpv_confirmation

string

DPV onayı için olası değerler. Tek bir karakter döndürür veya hiçbir değer döndürmez.

  • N: Birincil ve ikincil numara bilgileri DPV ile onaylanamadı.
  • D: Adres, yalnızca birincil numara için DPV onaylıydı ve ikincil numara bilgileri eksikti.
  • S: Adres yalnızca birincil numara için DPV onayı almış, ikincil numara bilgileri mevcut ancak onaylanmamış.
  • Y: Adres, birincil ve ikincil numaralar için DPV onayı aldı.
  • Boş: Yanıt dpv_confirmation değeri içermiyorsa adres, DPV onayı için gönderilmemiştir.
dpv_footnote

string

Teslim noktası doğrulamasındaki dipnotlar. Birden fazla dipnot aynı dizeye bağlanabilir.

  • AA: ZIP+4 dosyasıyla eşleşen giriş adresi
  • A1: Giriş adresi, ZIP+4 dosyasıyla eşleşmedi
  • BB: DPV ile eşleşen (tüm bileşenler)
  • CC: İkincil numara eşleşmedi ve gerekli değil
  • C1: İkincil numara eşleşmedi ancak gerekli
  • N1: Yüksek katlı binanın adresinde ikincil numara eksik
  • M1: Birincil numara eksik
  • M3: Birincil numara geçersiz
  • P1: Giriş adresi PO, RR veya HC kutusu numarası eksik
  • P3: Giriş adresi PO, RR veya HC Box numarası geçersiz
  • F1: Giriş adresi, askeri bir adresle eşleşti
  • G1: Genel teslimat adresiyle eşleşen giriş adresi
  • U1: Benzersiz bir posta koduyla eşleşen adres girin
  • PB: PBSA kaydıyla eşleşen giriş adresi
  • RR: DPV, PMB bilgileriyle onaylanmış adres
  • R1: PMB bilgileri olmadan DPV onaylı adres
  • R7: Operatör Rotası R777 veya R779 kaydı
  • IA: Bilgilendirilen Adres tanımlandı
  • TA: Sonuna bir alfabe karakteri ekleyerek eşleşen birincil sayı
dpv_cmra

string

Adresin CMRA (Ticari Posta Alma Ajansı) olup olmadığını belirtir. CMRA, müşteriler için posta alan özel bir işletmedir. Tek bir karakter döndürür.

  • Y: Adres bir CMRA
  • N: Adres CMRA değildir
dpv_vacant

string

Bu yer boş mu? Tek bir karakter döndürür.

  • Y: Adres boş
  • N: Adres boş değil
dpv_no_stat

string

Bu adres istatistikleri olmayan bir adres mi yoksa etkin bir adres mi? Statik adresler, sürekli olarak kullanılmayan veya USPS'nin hizmet vermediği adreslerdir. Tek bir karakter döndürür.

  • Y: Adres etkin değil
  • N: Adres etkin
dpv_no_stat_reason_code

int32

NoStat türünü belirtir. Neden kodunu int olarak döndürür.

  • 1: IDA (Dahili Posta Adresi) – Doğrudan USPS'den posta almayan ancak kendilerine hizmet veren bir posta adresine teslim edilen adresler.
  • 2: CDS: Henüz teslimat için hazır olmayan adresler. Örneğin, parsellerin ve birincil numaraların belirlendiği ancak henüz yerleşim için yapı bulunmayan yeni bir alt bölüm.
  • 3: Çakışma: DPV doğrulaması yapılmayan adresler.
  • 4: CMZ (Üniversite, Askeri ve Diğer Türler): ZIP + 4 kayıt USPS'nin verilere dahil ettiği kayıtlar.
  • 5: Normal: Teslimat almayan adresleri ve adreslerin olası teslimat olarak sayılmadığını belirtir.
  • 6: İkincil Bilgi Gerekli: Adres için ikincil bilgiler gereklidir.
dpv_drop

string

İşaret, postanın bir sitedeki tek bir alıcıya teslim edildiğini gösterir. Tek bir karakter döndürür.

  • Y: Posta, sitedeki tek bir alıcıya teslim edilir.
  • N: Posta, bir sitedeki tek bir posta kutusuna teslim edilmiyor.
dpv_throwback

string

Postanın sokak adresine teslim edilmediğini gösterir. Tek bir karakter döndürür.

  • Y: Posta, açık adrese teslim edilmiyor.
  • N: Posta, açık adrese teslim edilir.
dpv_non_delivery_days

string

İşaret, posta tesliminin haftanın her günü yapılmadığını gösterir. Tek bir karakter döndürür.

  • Y: Posta teslimatı, haftanın her günü gerçekleştirilmez.
  • N: Posta teslimatının haftanın her günü yapılmadığına dair bir gösterge yok.
dpv_non_delivery_days_values

int32

Yayınlanmayan günleri tanımlayan tam sayı. Bit işaretleri kullanılarak sorgulanabilir: 0x40 – Pazar teslimat yapılmayan gündür 0x20 – Pazartesi teslimat yapılmayan gündür 0x10 – Salı teslimat yapılmayan gündür 0x08 – Çarşamba teslimat yapılmayan gündür 0x04 – Perşembe teslimat yapılmayan gündür 0x02 – Cuma teslimat yapılmayan gündür 0x01 – Cumartesi teslimat yapılmayan gündür

dpv_no_secure_location

string

İşaret, kapıya erişilebildiğini ancak güvenlik nedeniyle paketin bırakılmayacağını gösterir. Tek bir karakter döndürür.

  • Y: Güvenlik nedeniyle paket bırakılmaz.
  • N: Güvenlik endişeleri nedeniyle paketin bırakılmayacağına dair bir gösterge yok.
dpv_pbsa

string

Adresin PBSA kaydıyla eşleştiğini gösterir. Tek bir karakter döndürür.

  • Y: Adres, PBSA kaydıyla eşleşti.
  • N: Adres, PBSA kaydıyla eşleşmedi.
dpv_door_not_accessible

string

İşaret, USPS'nin posta teslim etmek için kapıyı açamayacağı adresleri gösterir. Tek bir karakter döndürür.

  • Y: Kapıya erişilemez.
  • N: Kapıya erişilemediğine dair bir işaret yok.
dpv_enhanced_delivery_code

string

Adres için birden fazla DPV dönüş kodu geçerli olduğunu gösterir. Tek bir karakter döndürür.

  • Y: Adres, birincil ve ikincil numaralar için DPV onayı aldı.
  • N: Birincil ve ikincil numara bilgileri DPV ile onaylanamadı.
  • S: Adres, yalnızca birincil numara için DPV onaylandı. İkincil numara bilgisi mevcut ancak onaylanmadı. DPV eşleşmesinin sağlanması ve ikincil bilgilerin zorunlu kılınması için birincil numarada sondaki tek bir alfa kaldırıldı.
  • D: Adres, yalnızca birincil numara için DPV onaylıydı ve ikincil numara bilgileri eksikti.
  • R: Adres onaylandı ancak hayali rota R777 ve R779'a atandı ve USPS teslimatı sağlanmadı.
carrier_route

string

Kargo şirketinin rota kodu. Bir harfli ön ek ve üç haneli rota tanımlayıcısı içeren dört karakterli bir kod.

Önekler:

  • C: Operatör rotası (veya şehir rotası)
  • R: Kırsal rota
  • H: Otoyol Sözleşme Rotası
  • B: Posta Kutusu Bölümü
  • G: Genel yayınlama birimi
carrier_route_indicator

string

Operatör rota ücreti sıralama göstergesi.

ews_no_match

bool

Teslimat adresi eşleştirilebilir ancak EWS dosyası, bir tam eşlemenin yakında kullanıma sunulacağını belirtiyor.

post_office_city

string

Ana posta ofisi şehri.

post_office_state

string

Ana posta ofisi durumu.

abbreviated_city

string

Kısaltılmış şehir.

fips_county_code

string

FIPS ilçe kodu.

county

string

İlçe adı.

elot_number

string

Geliştirilmiş Seyahat Hattı (eLOT) numarası.

elot_flag

string

eLOT Artan/Azalan İşaret (A/D).

po_box_only_postal_code

bool

Yalnızca posta kutusu posta kodu.

pmb_designator

string

PMB (Özel Posta Kutusu) birimi tanımlayıcısı.

pmb_number

string

PMB (Özel Posta Kutusu) numarası;

address_record_type

string

Giriş adresiyle eşleşen adres kaydının türü.

  • F: FİRMA. Bu, bir firma kaydıyla eşleşmedir. Bu, bir adres için kullanılabilen en hassas eşleşme düzeyidir.
  • G: GENEL TESLİMAT. Bu, genel teslimat kaydıyla eşleşmedir.
  • H: BİNA / Apartman. Bu, bir bina veya daire kaydıyla eşleşmedir.
  • P: POSTA KUTUSU. Bu, bir posta kutusuyla eşleşmedir.
  • R: KÖY YOLU veya KARAYOLU SÖZLEŞMESİ: Bu, bir Köy Yolu veya Karayolu Sözleşmesi kaydıyla eşleşmedir. Her ikisinin de ilişkili Posta Kutusu Numarası aralıkları olabilir.
  • S: SOKAK KAYDI: Bu, geçerli bir birincil numara aralığı içeren bir sokak kaydıyla eşleşmedir.
default_address

bool

Varsayılan bir adresin bulunduğunu ancak daha spesifik adreslerin bulunduğunu gösteren gösterge.

error_message

string

USPS veri alımıyla ilgili hata mesajı. Bu alan, yapay olarak oluşturulmuş adreslerin algılanması nedeniyle USPS işleme işlemi askıya alındığında doldurulur.

Bu hata mevcut olduğunda USPS veri alanları doldurulmayabilir.

cass_processed

bool

İsteğin CASS ile işlendiğini gösteren gösterge.

ValidateAddressRequest

Adres doğrulama isteği.

Alanlar
address

PostalAddress

Zorunlu. Doğrulanan adres. Biçimlendirilmemiş adresler address_lines aracılığıyla gönderilmelidir.

Bu girişteki alanların toplam uzunluğu 280 karakteri aşmamalıdır.

Desteklenen bölgeleri burada bulabilirsiniz.

Giriş adresindeki language_code değeri gelecekteki kullanımlar için ayrılmıştır ve bugün yok sayılır. Doğrulanmış adres sonucu, belirtilen adres için sistem tarafından tanımlandığı şekilde tercih edilen dile göre doldurulur.

Address Validation API, recipients ve organization içindeki değerleri yok sayar. Bu alanlardaki tüm değerler atılır ve döndürülmez. Lütfen bunları ayarlamayınız.

previous_response_id

string

İlk adres doğrulama isteği için bu alan boş olmalıdır. Tek bir adresi tam olarak doğrulamak için daha fazla istek gerekirse (örneğin, kullanıcının ilk doğrulamadan sonra yaptığı değişikliklerin yeniden doğrulanması gerekiyorsa) her takip isteği bu alanı doğrulama sırasının ilk yanıtındaki response_id ile doldurmalıdır.

enable_usps_cass

bool

USPS CASS uyumlu modu etkinleştirir. Bu durum, google.maps.addressvalidation.v1.ValidationResult öğesinin google.maps.addressvalidation.v1.ValidationResult.usps_data alanını yalnızca etkiler. Not: Porto Riko'daki adresler için USPS CASS etkinleştirilmiş isteklerde, address google.type.PostalAddress.region_code değeri "PR" olarak veya address google.type.PostalAddress.administrative_area değeri "Porto Riko" (büyük/küçük harf duyarlı değildir) veya "PR" olarak sağlanmalıdır.

Bileşenli bir address kullanılması önerilir. Alternatif olarak, ilk satırın sokak numarasını ve adını, ikinci satırın ise şehri, eyaletini ve posta kodunu içerdiği en az iki google.type.PostalAddress.address_lines belirtebilirsiniz.

language_options

LanguageOptions

İsteğe bağlı. Önizleme: Bu özellik önizleme aşamasındadır (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Adres Doğrulama API'sinin yanıta ek bilgiler eklemesini sağlar.

session_token

string

İsteğe bağlı. Faturalandırma amacıyla bir Otomatik Tamamlama oturumunu tanımlayan dize. En fazla 36 ASCII karakter uzunluğunda, URL ve dosya adı için güvenli bir base64 dizesi olmalıdır. Aksi takdirde INVALID_ARGUMENT hatası döndürülür.

Oturum, kullanıcı bir Otomatik Tamamlama sorgusu yaptığında başlar ve kullanıcı bir yer seçip Yer Ayrıntıları veya Adres Doğrulama çağrısı yapıldığında sona erer. Her oturumda birden fazla Otomatik Tamamlama sorgusu ve ardından bir Yer Ayrıntıları veya Adres Doğrulama isteği olabilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Bir oturum sona erdiğinde jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. sessionToken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Not: Adres Doğrulama, yalnızca Autocomplete API ile değil, Autocomplete (Yeni) API ile olan oturumlarda kullanılabilir. Daha fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/session-pricing adresini ziyaret edin.

ValidateAddressResponse

Adres doğrulama isteğine verilen yanıt.

Alanlar
result

ValidationResult

Adres doğrulamasının sonucu.

response_id

string

Bu yanıtı tanımlayan UUID. Adresin yeniden doğrulanması gerekiyorsa bu UUID yeni isteğe eklenmelidir.

ValidationResult

Bir adresin doğrulanmasının sonucu.

Alanlar
verdict

Verdict

Genel karar işaretleri

address

Address

Coğrafi kod yerine adresin kendisiyle ilgili bilgiler.

geocode

Geocode

Adresin coğrafi olarak kodlandığı konum ve yer hakkında bilgiler.

metadata

AddressMetadata

Teslimatla ilgili diğer bilgiler. metadata değerinin, Address Validation API'ye gönderilen her adres için tam olarak doldurulacağı garanti edilmez.

usps_data

UspsData

USPS tarafından sağlanan ek teslim edilebilirlik işaretleri. Yalnızca US ve PR bölgelerinde sağlanır.

english_latin_address

Address

Önizleme: Bu özellik önizleme sürümündedir (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca, bu ürün ve özelliklerde yapılan değişiklikler GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Adresin İngilizceye çevrilmiş hali.

Çevrilmiş adresler API girişi olarak yeniden kullanılamaz. Hizmet, kullanıcının orijinal olarak sağlanan adresin doğrulanmasını onaylamak veya reddetmek için kendi ana dilini kullanabilmesi amacıyla bu seçenekleri sunar.

Adresin bir kısmının İngilizce çevirisi yoksa hizmet bu kısmı Latin alfabesi kullanan alternatif bir dilde döndürür. Alternatif dilin nasıl seçildiğiyle ilgili açıklama için burayı inceleyin. Adresin bir kısmının Latin alfabesi kullanan bir dilde çevirisi veya transliterasyonu yoksa hizmet bu kısmı adresle ilişkili yerel dilde döndürür.

google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address işaretini kullanarak bu çıkışı etkinleştirin.

Not: english_latin_address alanındaki google.maps.addressvalidation.v1.Address.unconfirmed_component_types alanı, english_latin_address.address_components içindeki google.maps.addressvalidation.v1.AddressComponent.confirmation_level alanları doldurulmaz.

Sonuç

Adres doğrulama sonucuna ve coğrafi kodlamaya genel bakış.

Alanlar
input_granularity

Granularity

Giriş adresinin ayrıntı düzeyi. Bu, giriş adresinin ayrıştırılmasından kaynaklanır ve herhangi bir doğrulama sinyali sağlamaz. Doğrulama sinyalleri için aşağıdaki validation_granularity bölümüne bakın.

Örneğin, giriş adresi belirli bir daire numarasını içeriyorsa buradaki input_granularity değeri SUB_PREMISE olur. Apartman numarası veritabanlarında eşleşemezse veya geçersizse validation_granularity muhtemelen PREMISE veya daha düşük olur.

validation_granularity

Granularity

API'nin adresi tam olarak doğrulayabileceği ayrıntı düzeyi. Örneğin, PREMISE için validation_granularity değeri, PREMISE veya daha genel düzeydeki tüm adres bileşenlerinin doğrulanabileceğini gösterir.

Adres bileşeni başına doğrulama sonucunu google.maps.addressvalidation.v1.Address.address_components'te bulabilirsiniz.

geocode_granularity

Granularity

geocode öğesinin ayrıntı düzeyi hakkında bilgi. Bu, coğrafi kodlanmış konumun ne kadar kaba veya hassas olduğunun anlamsal anlamı olarak anlaşılabilir.

Bu, zaman zaman yukarıdaki validation_granularity'dan farklı olabilir. Örneğin, veritabanımız bir apartman numarasının varlığını kaydedebilir, ancak büyük bir apartman kompleksindeki dairenin tam konumu olmayabilir. Bu durumda, validation_granularity SUB_PREMISE, geocode_granularity ise PREMISE olur.

address_complete

bool

Çözümlenmemiş simge ya da beklenmedik veya eksik adres bileşeni yoksa adres tamamlanmış olarak kabul edilir. Ayarlanmadan bırakılırsa değerin false olduğunu gösterir. Daha fazla ayrıntı için missing_component_types, unresolved_tokens veya unexpected alanlarına bakın.

has_unconfirmed_components

bool

En az bir adres bileşeni kategorize edilemiyor veya doğrulanamıyor. Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components bölümüne bakın.

has_inferred_components

bool

Girişte bulunmayan en az bir adres bileşeni çıkarıldı (eklendi). Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components bölümüne bakın.

has_replaced_components

bool

En az bir adres bileşeni değiştirildi. Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components adresine göz atın.

Ayrıntı düzeyi

Bir adresin veya coğrafi kodun sahip olabileceği çeşitli ayrıntı düzeyleri. Bir adres için ayrıntı düzeyini belirtmek amacıyla kullanıldığında bu değerler, adresin posta adresini ne kadar ayrıntılı bir şekilde tanımladığını gösterir. Örneğin, "123 Ana Cadde, Redwood City, CA, 94061" gibi bir adres PREMISE'ü, "Redwood City, CA, 94061" gibi bir adres ise LOCALITY'ü tanımlar. Ancak Redwood City'deki "123 Main Street" için coğrafi kod bulamıyorsak adres daha ayrıntılı olsa bile döndürülen coğrafi kod LOCALITY ayrıntı düzeyinde olabilir.

Sıralamalar
GRANULARITY_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
SUB_PREMISE Apartman gibi bina düzeyinin altındaki sonuç.
PREMISE Bina düzeyinde sonuç.
PREMISE_PROXIMITY Adresin bina düzeyindeki konumuna yaklaşık olarak karşılık gelen bir coğrafi kod.
BLOCK Adres veya coğrafi kod bir bloğu gösterir. Yalnızca Japonya gibi blok düzeyinde adresleme bulunan bölgelerde kullanılır.
ROUTE Coğrafi kod veya adres, cadde, yol veya otoyol gibi rotaya göre ayrıntılıdır.
OTHER Teslim edilebilir olmadıkları için bir arada toplanan diğer tüm ayrıntı düzeyiler.