Dizin
AddressValidation
(arayüz)Address
(message)AddressComponent
(message)AddressComponent.ConfirmationLevel
(enum)AddressMetadata
(message)ComponentName
(message)Geocode
(message)LanguageOptions
(message)PlusCode
(message)ProvideValidationFeedbackRequest
(message)ProvideValidationFeedbackRequest.ValidationConclusion
(enum)ProvideValidationFeedbackResponse
(message)UspsAddress
(message)UspsData
(message)ValidateAddressRequest
(message)ValidateAddressResponse
(message)ValidationResult
(message)Verdict
(message)Verdict.Granularity
(enum)
AddressValidation
Adresleri doğrulama hizmeti.
ProvideValidationFeedback |
---|
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 |
---|
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 |
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 |
Posta adresi olarak gösterilen, sonradan işlenmiş adres. |
address_components[] |
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[] |
Doğru biçimlendirilmiş bir posta adresinde olması beklenen ancak girişte bulunmayan bileşenlerin türleri tahmin edilemedi. Bu tür bileşenler |
unconfirmed_component_types[] |
|
unresolved_tokens[] |
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 |
AddressComponent
Sokak, şehir veya eyalet gibi bir adres bileşenini temsil eder.
Alanlar | |
---|---|
component_name |
Bu bileşenin adı. |
component_type |
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 |
Bileşenin doğru olduğuna dair kesinlik düzeyini gösterir. |
inferred |
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 |
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 |
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 |
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 |
Bir işletmenin adresi olduğunu belirtir. Ayarlanmaması, değerin bilinmediğini gösterir. |
po_box |
Bir posta kutusunun adresini belirtir. Ayarlanmaması, değerin bilinmediğini gösterir. |
residential |
Bunun bir konut adresi olduğunu belirtir. Ayarlanmaması, değerin bilinmediğini gösterir. |
ComponentName
Bileşenin adı için sarmalayıcı.
Alanlar | |
---|---|
text |
Ad metni. Örneğin, sokak adı için "5. Cadde" veya sokak numarası için "1253". |
language_code |
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 |
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 |
|
bounds |
Coğrafi olarak kodlanan yerin sınırları. |
feature_size_meters |
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 |
Bu girişin coğrafi olarak kodlandığı yerin PlaceID. Yer Kimlikleri hakkında daha fazla bilgiyi burada bulabilirsiniz. |
place_types[] |
Girişin coğrafi kodlamasını yaptığınız yerin türleri. Örneğin, |
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 |
Önizleme: İngilizce olarak bir |
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 |
Yerin, 1/8000 x 1/8000 derecelik bir alanı (~14x14 metre) temsil eden, "9FWM33GV+HQ" gibi global (tam) kodu. |
compound_code |
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 |
Zorunlu. Doğrulama denemeleri sırasının sonucu. Bu alan, |
response_id |
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 |
İlk adres satırı. |
firm |
Firma adı. |
second_address_line |
İkinci adres satırı. |
urbanization |
Porto Riko'daki kentleşme adı. |
city_state_zip_address_line |
Şehir + eyalet + posta kodu. |
city |
Şehir adı. |
state |
2 harfli eyalet kodu. |
zip_code |
Posta kodu, ör. 10009. |
zip_code_extension |
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 |
USPS standartlaştırılmış adres. |
delivery_point_code |
2 haneli teslimat noktası kodu |
delivery_point_check_digit |
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 |
DPV onayı için olası değerler. Tek bir karakter döndürür veya hiçbir değer döndürmez.
|
dpv_footnote |
Teslim noktası doğrulamasındaki dipnotlar. Birden çok dipnot aynı dize içinde birbirine dökülebilir.
|
dpv_cmra |
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.
|
dpv_vacant |
Burası boş bir yer mi? Tek bir karakter döndürür.
|
dpv_no_stat |
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.
|
dpv_no_stat_reason_code |
NoStat türünü belirtir. Neden kodunu int olarak döndürür.
|
dpv_drop |
İşaret, postaların bir sitedeki tek bir alıcıya teslim edildiğini gösterir. Tek bir karakter döndürür.
|
dpv_throwback |
Postanın açık adrese teslim edilmediğini belirtir. Tek bir karakter döndürür.
|
dpv_non_delivery_days |
İşaret, posta tesliminin haftanın her günü gerçekleştirilmediğini gösterir. Tek bir karakter döndürür.
|
dpv_non_delivery_days_values |
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 |
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.
|
dpv_pbsa |
Adresin PBSA kaydıyla eşleştirildiğini belirtir. Tek bir karakter döndürür.
|
dpv_door_not_accessible |
Bayrak, USPS'nin posta teslim etmek için bir kapıyı çalamayacağı adresleri belirtir. Tek bir karakter döndürür.
|
dpv_enhanced_delivery_code |
Adres için birden fazla DPV dönüş kodunun geçerli olduğunu belirtir. Tek bir karakter döndürür.
|
carrier_route |
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:
|
carrier_route_indicator |
Kargo şirketi rota hızı sıralama göstergesi. |
ews_no_match |
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 |
Ana postane şehri. |
post_office_state |
Ana postane eyaletidir. |
abbreviated_city |
Kısaltılmış şehir. |
fips_county_code |
FIPS ülke kodu. |
county |
İlçe adı. |
elot_number |
Geliştirilmiş Seyahat Hattı (eLOT) numarası. |
elot_flag |
eLOT Artan/Azalan İşaret (A/D). |
lacs_link_return_code |
LACSLink dönüş kodu. |
lacs_link_indicator |
LACSLink göstergesi. |
po_box_only_postal_code |
Yalnızca Posta Kutusu posta kodu. |
suitelink_footnote |
Sokak veya çok katlı binaların daire bilgileriyle eşleştirilmesinden elde edilen dipnotlar. İşletme adı eşleşmesi bulunursa ikincil numara döndürülür.
|
pmb_designator |
PMB (Özel Posta Kutusu) birimi belirteci. |
pmb_number |
PMB (Özel Posta Kutusu) numarası; |
address_record_type |
Giriş adresiyle eşleşen adres kaydının türü.
|
default_address |
Varsayılan bir adresin bulunduğunu, ancak daha spesifik adreslerin mevcut olduğunu gösteren gösterge. |
error_message |
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 |
İsteğin CASS tarafından işlendiğine dair gösterge. |
ValidateAddressRequest
Adres doğrulama isteği.
Alanlar | |
---|---|
address |
Zorunlu. Doğrulanan adres. Biçimlendirilmemiş adresler Bu girişteki alanların toplam uzunluğu 280 karakteri aşmamalıdır. Desteklenen bölgeleri burada bulabilirsiniz. Giriş adresindeki Address Validation API, |
previous_response_id |
İ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 |
enable_usps_cass |
USPS CASS uyumlu modunu etkinleştirir. Bu durum yalnızca Bileşenleştirilmiş bir |
language_options |
İ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 |
İ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. 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 |
Adres doğrulamasının sonucu. |
response_id |
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 |
Genel karar işaretleri |
address |
Coğrafi kodlamanın aksine, adresin kendisiyle ilgili bilgiler. |
geocode |
Adresin coğrafi kodlaması yapılan konum ve yerle ilgili bilgiler. |
metadata |
Teslimatla ilgili diğer bilgiler. |
usps_data |
USPS tarafından sağlanan ekstra teslimat işaretleri. Yalnızca |
english_latin_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.
Not: |
Sonuç
Adres doğrulama sonucu ve coğrafi koda üst düzey genel bakış.
Alanlar | |
---|---|
input_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 Örneğin, giriş adresi belirli bir apartman numarasını içeriyorsa buradaki |
validation_granularity |
API'nin adresi tamamen validate ayrıntı düzeyi. Örneğin, Adres başına bileşen doğrulama sonucu |
geocode_granularity |
Bu, zaman zaman yukarıdaki |
address_complete |
Çözümlenmemiş jeton veya beklenmedik ya da eksik adres bileşeni yoksa adres tamamlanmış olarak kabul edilir. Ayarlanmadan bırakılırsa |
has_unconfirmed_components |
En az bir adres bileşeni kategorize edilemiyor veya doğrulanamıyor. Ayrıntılar için |
has_inferred_components |
Girişte yer almayan en az bir adres bileşeni tahmin edildi (eklendi). Ayrıntılar için |
has_replaced_components |
En az bir adres bileşeni değiştirildi. Ayrıntılar için |
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. |