Package google.maps.addressvalidation.v1

Dizin

AddressValidation

Adresleri doğrulama hizmeti.

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Doğrulama girişimi sırasının sonucu hakkında geri bildirim. Bu, aynı adres için 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, 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ı. Adresin yanlış yazılmış kısımlarının düzeltilmesi, yanlış parçaların değiştirilmesi ve eksik parçalarla ilgili çıkarımların yapılması, işleme sonrası sürecine dahildir.

Alanlar
formatted_address

string

Adresin bulunduğu bölgenin adres biçimlendirme kurallarına göre tek satırlı bir adres olarak biçimlendirilmiş ve işlendikten sonra olduğu adres.
postal_address

PostalAddress

Posta adresi olarak gösterilen, sonradan işlenmiş adres.
address_components[]

AddressComponent

Sırasız liste. Doğrulama bilgileriyle birlikte biçimlendirilmiş ve düzeltilmiş adresin bağımsız adres bileşenleri. Bu, her bir bileşenin doğrulama durumu hakkında bilgi sağlar.

Adres bileşenleri belirli bir şekilde sıralanmamıştır. Listedeki adres bileşenlerinin sıralamasıyla ilgili varsayımlarda bulunmayın.
missing_component_types[]

string

Doğru biçimlendirilmiş bir posta adresinde olması beklenen ancak girişte bulunmayan bileşenlerin türleri tahmin edilemedi. Bu tür bileşenler formatted_address, postal_address veya address_components içinde mevcut değil. "Boulder, Colorado, 80301, ABD" gibi bir giriş için ['street_number', 'route'] verilebilir. Olası türlerin listesine buradan ulaşabilirsiniz.
unconfirmed_component_types[]

string

address_components içinde bulunan ancak doğruluğu onaylanamayan bileşenlerin türleri. Bu alan, kolaylık sağlamak amacıyla verilmiştir: Bu alanın içeriği, confirmation_level öğesinin CONFIRMED olmadığı veya inferred işaretinin true olarak ayarlanmadığı tüm bileşenlerin türlerini bulmak için address_components üzerinden yineleme yapılması eşdeğerdir. Olası türlerin listesine buradan ulaşabilirsiniz.
unresolved_tokens[]

string

Girişteki çözümlenemeyen tüm jetonlar. Bu, bir adresin geçerli bölümü olarak tanınmayan bir giriş olabilir (örneğin, "123235253253 Main St, San Francisco, CA, 94105" gibi bir girişte çözümlenmemiş jetonlar ["123235253253"] şeklinde görünebilir, çünkü bu, geçerli bir sokak numarası gibi görünmemektedir.

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ğuna dair kesinlik düzeyini gösterir.
inferred

bool

Bileşenin, girişin bir parçası olmadığını ancak adres konumu için tahmin ettiğimizi ve tam adres için sağlanması gerektiğini düşündüğümüzü belirtir.
spell_corrected

bool

Bileşen adındaki bir yazım hatasının düzeltmesini gösterir. API, "orta"nın "orta" olarak değiştirilmesi gibi farklı yazım biçimlerindeki değişiklikleri her zaman işaretlemez. Ayrıca, "Pkwy" ifadesinin "Amfiteatr Pkwy" olarak değiştirilmesi gibi sık karşılaşılan yazım hataları her zaman işaretlenmez.
replaced

bool

Bileşen adının tamamen farklı bir adla değiştirildiğini (örneğin, yanlış bir posta kodunun adres için doğru olan bir posta koduyla değiştirilmesi) gösterir. Bu bir görünüm değişikliği değildir. Giriş bileşeni farklı bir bileşenle değiştirildi.
unexpected

bool

Belirli bir bölge için posta adresinde mevcut olması beklenmeyen bir adres bileşenini gösterir. Bu bilgiyi 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ılmıyor.
CONFIRMED Bu bileşenin var olduğunu ve adresin geri kalanında mantıklı olduğunu doğrulayabildik.
UNCONFIRMED_BUT_PLAUSIBLE Bu bileşen onaylanamadı, ancak mevcut olması muhtemeldir. Örneğin, belirli ev numaralarının bilinmediği bir caddedeki bilinen geçerli bir numara aralığındaki sokak numarası.
UNCONFIRMED_AND_SUSPICIOUS Bu bileşen onaylanmadı ve muhtemelen yanlış olabilir. Örneğin, adresin geri kalanına uymayan bir mahalle.

AddressMetadata

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

Alanlar
business

bool

Bir işletmenin adresi olduğunu belirtir. Ayarlanmaması, değerin bilinmediğini gösterir.
po_box

bool

Bir posta kutusunun adresini belirtir. Ayarlanmaması, değerin bilinmediğini gösterir.
residential

bool

Bunun bir konut adresi olduğunu belirtir. Ayarlanmaması, değerin bilinmediğini gösterir.

ComponentName

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

Alanlar
text

string

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

string

BCP-47 dil kodu. Bileşen adı sokak numarası gibi bir dille ilişkilendirilmemişse bu uyarı görünmez.

Coğrafi kod

Girişin coğrafi kodlamasının yapıldığı yer hakkında bilgi içerir.

Alanlar
location

LatLng

Girişin coğrafi olarak kodlanmış konumu.

Adres, enlem/boylam koordinatları veya artı kodları yerine yer kimliklerinin kullanılması tercih edilir. Arabayla yol tariflerinin rotasını belirlerken veya hesaplarken koordinatlar kullanıldığında, nokta her zaman bu koordinatlara en yakın yola tutturulur. Bu yol, hedefe hızlı veya güvenli bir şekilde giden bir yol olmayabilir ve tesise erişim noktasının yakınında olmayabilir. Ayrıca bir konumun coğrafi kodlaması ters olduğunda, döndürülen adresin orijinal adresle eşleşeceğine dair bir garanti yoktur.
plus_code

PlusCode

location öğesine karşılık gelen artı kodu.
bounds

Viewport

Coğrafi olarak kodlanan yerin sınırları.
feature_size_meters

float

Coğrafi olarak kodlanan yerin metre cinsinden boyutu. Bu, coğrafi kodlaması yapılmış konumun yüzeysellik düzeyinin başka bir ölçüsüdür, ancak semantik anlam yerine fiziksel boyuttadır.
place_id

string

Bu girişin coğrafi olarak kodlandığı yerin PlaceID.

Yer Kimlikleri hakkında daha fazla bilgiyi burada bulabilirsiniz.
place_types[]

string

Girişin coğrafi kodlamasını yaptığınız yerin türleri. Örneğin, ['locality', 'political']. Türlerin tam listesini burada bulabilirsiniz.

LanguageOptions

Önizleme: Bu özellik Önizleme aşamasındadır (GKST öncesi). GKST öncesi ürün ve özelliklere verilen destek sınırlı olabilir ve 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 Hizmetine Özel Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Address Validation API'yi yanıta ek bilgiler dahil edecek şekilde etkinleştirir.

Alanlar
return_english_latin_address

bool

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

PlusCode

Artı kodu (http://plus.codes), iki biçime sahip bir konum referansıdır: 14mx14m (1/8000'i) veya daha küçük bir dikdörtgeni tanımlayan global kod ve ön eki referans konumuyla değiştiren bileşik kod.

Alanlar
global_code

string

Yerin, 1/8000 x 1/8000 derecelik bir alanı (~14x14 metre) temsil eden, "9FWM33GV+HQ" gibi global (tam) kodu.
compound_code

string

Yerin bileşik kodu. Örneğin, "33GV+HQ, Ramberg, Norveç". Global kodun son ekini içerir ve ön eki, referans varlığın biçimlendirilmiş adıyla değiştirir.

ProvideValidationFeedbackRequest

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

Alanlar
conclusion

ValidationConclusion

Zorunlu. Doğrulama denemeleri sırasının sonucu.

Bu alan, VALIDATION_CONCLUSION_UNSPECIFIED değerine ayarlanırsa INVALID_ARGUMENT hatası döndürülür.
response_id

string

Zorunlu. Bu geri bildirimin ilgili olduğu yanıtın kimliği. Bu, bir dizi adres doğrulama girişiminde verilen ilk yanıttaki [Response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] kodu olmalıdır.

ValidationConclusion

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

Sıralamalar
VALIDATION_CONCLUSION_UNSPECIFIED Bu değer kullanılmıyor. 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 Kullanıcı tarafından sağlanan adresin sürümü, işlem için kullanıldı
UNVALIDATED_VERSION_USED İşlem için, son doğrulama denemesinden sonra girilen, ancak yeniden doğrulanmamış bir adres sürümü kullanıldı.
UNUSED İşlem iptal edildi ve adres kullanılmadı.

ProvideValidationFeedbackResponse

Bu türde alan yok.

Doğrulama geri bildirimi yanıtı.

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

UspsAddress

ABD'deki bir adresin 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şme adı.
city_state_zip_address_line

string

Şehir + eyalet + posta kodu.
city

string

Şehir adı.
state

string

2 harfli eyalet kodu.
zip_code

string

Posta kodu, ör. 10009.
zip_code_extension

string

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

UspsData

Adrese ait USPS verileri. uspsData adresinin, Address Validation API'ye gönderilen her US veya PR adresi için tam olarak doldurulacağı garanti edilmez. Yanıtın birincil parçası olarak uspsData'yı kullanıyorsanız yedek adres alanlarını yanıta entegre etmeniz önerilir.

Alanlar
standardized_address

UspsAddress

USPS standartlaştırılmış adres.
delivery_point_code

string

2 haneli teslimat noktası kodu
delivery_point_check_digit

string

Teslimat noktası kontrol basamağı. Bu sayı, mekanik olarak taranan postalar için delivery_point_barcode öğesinin sonuna eklenir. Delivery_point_barcode, delivery_point_check_ geçirir, posta kodu ve ZIP+4 öğelerinin tüm rakamları toplandığında 10'a bölünebilen bir sayı elde edilir.
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 doğrulanamadı.
  • D: Adres yalnızca birincil numara için DPV olarak onaylandı ve ikincil numara bilgileri eksikti.
  • S: Adres DPV yalnızca birincil numara için onaylandı ve ikincil numara bilgisi mevcut ancak onaylanmadı.
  • Y: Adres, birincil ve ikincil numaralar için DPV olarak onaylandı.
  • Boş: Yanıt bir dpv_confirmation değeri içermiyorsa adres, DPV onayı için gönderilmemiş demektir.
dpv_footnote

string

Teslim noktası doğrulamasındaki dipnotlar. Birden çok dipnot aynı dize içinde birbirine dökülebilir.

  • 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şti (tüm bileşenler)
  • CC: İkincil numara eşleşmedi ve gerekli değil
  • C1: İkincil numara eşleşmedi ancak gerekli
  • N1: Çok katlı adreste ikincil numara eksik
  • M1: Birincil numara eksik
  • M3: Birincil numara geçersiz
  • P1: Giriş adresi PO, RR veya HC kutu numarası eksik
  • P3: Giriş adresi PO, RR veya HC Box numarası geçersiz
  • F1: Askeri adresle eşleşen giriş adresi
  • G1: Genel teslimat adresiyle eşleşen giriş adresi
  • U1: Benzersiz bir posta koduyla eşleşen giriş adresi
  • PB: Giriş adresi, PBSA kaydıyla eşleşti
  • RR: PMB bilgilerine sahip DPV onaylı adres
  • R1: PMB bilgisi içermeyen DPV onaylı adres
  • R7: Operatör Rotası R777 veya R779 kaydı
  • IA: Bilgi verilen adres tespit edildi
  • TA: Sondaki alfa çıkarılarak eşleştirilen birincil sayı
dpv_cmra

string

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

  • Y: Adres bir CMRA'dır
  • N: Adres bir CMRA değil
dpv_vacant

string

Burası boş bir yer mi? Tek bir karakter döndürür.

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

string

Bu istatistik adresi yok mu yoksa etkin bir adres mi? Hiçbir istatistik adresi, sürekli dolu olmayan veya USPS'nin hizmet vermediği adresler değildir. 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 Açılır Adres) – Doğrudan USPS'den posta almayan ancak kendilerine hizmet veren bir gönderim adresine teslim edilen adresler.
  • 2: CDS - Henüz yayınlanabilir hale gelmemiş adresler. Örneğin, partilerin ve birincil sayıların belirlendiği yeni bir alt bölüm, ancak henüz doluluk için yapının bulunmadığı bir bölüm.
  • 3: Çarpışma - DPV doğrulaması yapmayan adresler.
  • 4: CMZ (Üniversite, Askeri ve Diğer Türler) - USPS'nin verilere dahil ettiği ZIP + 4 kayıt.
  • 5: Normal - Adresin teslim alınmadığını ve bu adreslerin olası teslimat olarak sayılmadığını belirtir.
  • 6: İkincil Zorunlu - Adres için ikincil bilgi gerekiyor.
dpv_drop

string

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

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

string

Postanın açık adrese teslim edilmediğini belirtir. Tek bir karakter döndürür.

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

string

İşaret, posta tesliminin haftanın her günü gerçekleştirilmediğini gösterir. Tek bir karakter döndürür.

  • Y: Posta teslimi haftanın her günü gerçekleştirilmez.
  • N: Posta tesliminin haftanın her günü yapılmadığını göstermez.
dpv_non_delivery_days_values

int32

Teslim edilmeyen günleri tanımlayan tam sayı. Bit işaretleri kullanılarak sorgulanabilir: 0x40 – Pazar teslimat yapılmayan bir günü ifade eder 0x20 – Pazartesi teslimat yapılmayan bir günü temsil eder 0x10 – Salı teslimat yapılmayan bir gündür 0x08 – Çarşamba günü teslimat yapılmayan bir gündür 0x04 – Perşembe, teslimat yapılmayan bir gün 0x02 – Cuma 0x02 teslimat yapılmayan bir gündür 01 Cumartesi, teslimat yapılmayan bir gündür
dpv_no_secure_location

string

Bayrak, kapının erişilebilir olduğunu ancak güvenlikle ilgili nedenlerden dolayı paket bırakılmayacaktır. Tek bir karakter döndürür.

  • Y: Güvenlikle ilgili nedenlerden dolayı paket bırakılmayacak.
  • N: Güvenlikle ilgili endişeler nedeniyle paketin bırakılmayacağına dair bir işaret yok.
dpv_pbsa

string

Adresin PBSA kaydıyla eşleştirildiğini belirtir. Tek bir karakter döndürür.

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

string

Bayrak, USPS'nin posta teslim etmek için bir kapıyı çalamayacağı adresleri belirtir. Tek bir karakter döndürür.

  • Y: Kapıya erişilemiyor.
  • N: Kapının erişilebilir olmadığını belirten bir uyarı yok.
dpv_enhanced_delivery_code

string

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

  • Y: Adres, birincil ve ikincil numaralar için DPV olarak onaylandı.
  • N: Birincil ve ikincil numara bilgileri DPV doğrulanamadı.
  • S: Adresin DPV yalnızca birincil numara için olduğu onaylanmıştır ve ikincil numara bilgisi "onaylanmadı" şeklinde mevcuttur veya DPV eşleşmesi ve ikincil bilgiler sağlanması amacıyla birincil numaranın sonundaki tek bir alfa kaldırılmıştır.
  • D: Adres yalnızca birincil numara için DPV olarak onaylandı ve ikincil numara bilgileri eksikti.
  • R: Adres onaylandı, ancak R777 ve R779 hayali karayoluna atanmış ve USPS teslimatı sağlanmadı.
carrier_route

string

Operatörün rota kodu. Bir harfli ön ek ve üç basamaklı bir güzergah göstergesinden oluşan dört karakterli bir kod.

Ön ekler:

  • C: Taşıyıcı rotası (veya şehir karayolu)
  • R: Kırsal karayolu
  • H: Otoyol Sözleşme Rotası
  • B: Posta Kutusu Bölümü
  • G: Genel teslimat birimi
carrier_route_indicator

string

Kargo şirketi rota hızı sıralama göstergesi.
ews_no_match

bool

Teslim adresi eşleşiyor, ancak EWS dosyası, kısa bir süre içinde tam eşleşmenin hazır olacağını gösteriyor.
post_office_city

string

Ana postane şehri.
post_office_state

string

Ana postane eyaletidir.
abbreviated_city

string

Kısaltılmış şehir.
fips_county_code

string

FIPS ülke 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 belirteci.
pmb_number

string

PMB (Özel Posta Kutusu) numarası;
address_record_type

string

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

  • F: SABİT. Bu, bir adres için mevcut en iyi eşleşme düzeyi olan Tam Kayıt ile eşleşmedir.
  • G: GENEL TESLİM. Bu, Genel Teslim kaydı ile eşleşiyor.
  • H: YAPI / Daire. Bu değer, bir Bina veya Apartman kaydı ile eşleşiyor.
  • P: RESMİ KUTUSU. Bu, bir Postane Kutusu ile eşleşmedir.
  • R: KÖTÜ AMAÇLI ROTA veya YOL TARİHİ: Bu, her ikisi de ilişkili kutu numarası aralıklarına sahip olabilecek Kırsal Rota veya Otoyol Sözleşme kaydı ile eşleşir.
  • S: SOKAK KAYDI: Bu, geçerli bir birincil numara aralığı içeren bir Street kaydıyla eşleşmesidir.
default_address

bool

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

string

USPS veri alımı için hata mesajı. Bu alan, yapay olarak oluşturulmuş adreslerin algılanması nedeniyle USPS işlemesi askıya alındığında doldurulur.

Bu hata oluştuğunda USPS veri alanları doldurulmayabilir.
cass_processed

bool

İsteğin CASS tarafından işlendiğine dair gösterge.

ValidateAddressRequest

Adres doğrulama isteği.

Alanlar
address

PostalAddress

Zorunlu. Doğrulanan adres. Biçimlendirilmemiş adresler address_lines yoluyla 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 yoksayılmaktadır. Doğrulanan adres sonucu, sistem tarafından tanımlanan belirtilen adres için tercih edilen dile göre doldurulur.

Address Validation API, recipients ve organization içindeki değerleri yoksayar. Bu alanlardaki değerler silinir ve döndürülmez. Lütfen bunları ayarlamayın.
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 gerekiyorsa (örneğin, kullanıcının ilk doğrulamadan sonra yaptığı değişikliklerin yeniden doğrulanması gerekiyorsa) her takip isteğinde bu alanı doğrulama sırasındaki ilk yanıttan itibaren response_id ile doldurmalıdır.
enable_usps_cass

bool

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

Bileşenleştirilmiş bir address kullanmanız veya alternatif olarak, ilk satırda sokak numarası ve ad, ikinci satırda ise şehir, eyalet ve posta kodu olacak şekilde en az iki google.type.PostalAddress.address_lines belirtmeniz önerilir.
language_options

LanguageOptions

İsteğe bağlı. Önizleme: Bu özellik Önizleme aşamasındadır (GKST öncesi). GKST öncesi ürün ve özelliklere verilen destek sınırlı olabilir ve 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 Hizmetine Özel Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Address Validation API'yi yanıta ek bilgiler dahil edecek şekilde etkinleştirir.
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 bir URL ve dosya adı güvenli base64 dizesi olmalıdır. Aksi takdirde bir 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 gelebilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Oturum sona erdiğinde jeton artık geçerli olmaz; uygulamanızın her oturum için yeni bir jeton oluşturması gerekir. sessionToken parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Not: Adres Doğrulama yalnızca Otomatik Tamamlama (Yeni) API'sinin bulunduğu oturumlarda kullanılabilir, Otomatik Tamamlama API'si ile kullanılamaz. Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/session-pricing sayfasına bakın.

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'nin yeni isteğe eşlik etmesi gerekir.

ValidationResult

Adres doğrulamanın sonucu.

Alanlar
verdict

Verdict

Genel karar işaretleri
address

Address

Coğrafi kodlamanın aksine, adresin kendisiyle ilgili bilgiler.
geocode

Geocode

Adresin coğrafi kodlaması yapılan konum ve yerle ilgili bilgiler.
metadata

AddressMetadata

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

UspsData

USPS tarafından sağlanan ekstra teslimat işaretleri. Yalnızca US ve PR bölgelerinde sağlanır.
english_latin_address

Address

Önizleme: Bu özellik Önizleme aşamasındadır (GKST öncesi). GKST öncesi ürün ve özelliklere verilen destek sınırlı olabilir ve 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 Hizmetine Özel Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

Adres İngilizceye çevrilmiştir.

Çevrilen adresler API girişi olarak yeniden kullanılamaz. Hizmet, kullanıcının orijinal dilinde sağlanan adresin doğrulanmasını onaylamak veya reddetmek için kendi ana dilini kullanabilmesini sağlar.

Adresin bir kısmının İngilizce çevirisi yoksa hizmet, söz konusu bölümü Latin alfabesi kullanan alternatif bir dilde döndürür. Alternatif dilin nasıl seçildiğiyle ilgili açıklama için buraya bakın. Adresin bir kısmında Latin alfabesi kullanılan bir dilde çeviri veya harf çevirisi yoksa hizmet, adresle ilişkili yerel dilde o bölümü döndürür.

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

Not: english_latin_address içindeki google.maps.addressvalidation.v1.Address.unconfirmed_component_types ve english_latin_address.address_components içindeki google.maps.addressvalidation.v1.AddressComponent.confirmation_level alanları doldurulmamış.

Sonuç

Adres doğrulama sonucu ve coğrafi koda üst düzey 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 politikasına bakın.

Örneğin, giriş adresi belirli bir apartman numarasını içeriyorsa buradaki input_granularity, SUB_PREMISE olacaktır. Veritabanındaki daire numarasını eşleştiremezsek ya da daire numarası geçersizse validation_granularity büyük olasılıkla PREMISE veya daha küçük bir rakam olacaktır.
validation_granularity

Granularity

API'nin adresi tamamen validate ayrıntı düzeyi. Örneğin, validation_granularity değeri PREMISE değeri, PREMISE veya daha genel düzeyindeki tüm adres bileşenlerinin doğrulanabileceğini gösterir.

Adres başına bileşen doğrulama sonucu google.maps.addressvalidation.v1.Address.address_components içinde bulunabilir.
geocode_granularity

Granularity

geocode öğesinin ayrıntı düzeyi hakkında bilgi. Bu, coğrafi kodlaması yapılan konumun ne kadar yüzeysel veya hassas olduğunun semantik anlamı olarak anlaşılabilir.

Bu, zaman zaman yukarıdaki validation_granularity değerinden farklı olabilir. Örneğin, veritabanımız bir apartman numarasının varlığını kaydedebilir, ancak büyük bir apartman kompleksindeki dairenin kesin konumunu belirleyemeyebilir. Bu durumda, validation_granularity değeri SUB_PREMISE, geocode_granularity değeri ise PREMISE olur.
address_complete

bool

Çözümlenmemiş jeton veya beklenmedik ya da eksik adres bileşeni yoksa adres tamamlanmış olarak kabul edilir. Ayarlanmadan bırakılırsa false değeri gösterilir. Daha fazla bilgi 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 sayfasına bakın.
has_inferred_components

bool

Girişte yer almayan en az bir adres bileşeni tahmin edildi (eklendi). Ayrıntılar için google.maps.addressvalidation.v1.Address.address_components sayfasına göz atı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 sayfasına göz atın.

Ayrıntı düzeyi

Bir adresin veya coğrafi kodun sahip olabileceği çeşitli ayrıntı düzeyidir. Bir adres için ayrıntı düzeyini belirtmek amacıyla kullanıldığında bu değerler, adresin bir posta hedefini ne kadar ayrıntılı tanımladığını gösterir. Örneğin, "123 Main Street, Redwood City, CA, 94061" gibi bir adres PREMISE tanımlarken, "Redwood City, CA, 94061" gibi bir adres LOCALITY tanımlar. Bununla birlikte, Redwood City'de "123 Main Street" için coğrafi kodu bulamazsak, adres daha ayrıntılı olmasına rağmen döndürülen coğrafi kodlama LOCALITY ayrıntı düzeyinde olabilir.

Sıralamalar
GRANULARITY_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
SUB_PREMISE Bina seviyesinin altı sonucu (ör. apartman dairesi).
PREMISE Bina düzeyinde sonuç.
PREMISE_PROXIMITY Adresin bina düzeyindeki konumunu yaklaşık olarak gösteren bir coğrafi kod.
BLOCK Adres veya coğrafi kod bir bloğu belirtir. Yalnızca blok düzeyinde adreslemenin bulunduğu bölgelerde (ör. Japonya) kullanılır.
ROUTE Coğrafi kod veya adres, cadde, yol veya otoyol gibi ayrıntılı bir rotadır.
OTHER Teslimat olmadıkları için bir arada gruplanan diğer tüm ayrıntı düzeyleri.