Method: validateAddress

Memvalidasi alamat.

Permintaan HTTP

POST https://addressvalidation.googleapis.com/v1:validateAddress

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "address": {
    object (PostalAddress)
  },
  "previousResponseId": string,
  "enableUspsCass": boolean,
  "languageOptions": {
    object (LanguageOptions)
  },
  "sessionToken": string
}
Kolom
address

object (PostalAddress)

Wajib. Alamat yang sedang divalidasi. Alamat yang tidak diformat harus dikirimkan melalui addressLines.

Total panjang kolom dalam input ini tidak boleh melebihi 280 karakter.

Wilayah yang didukung dapat ditemukan di sini.

Nilai languageCode di alamat input dicadangkan untuk penggunaan pada masa mendatang dan diabaikan saat ini. Hasil alamat yang divalidasi akan diisi berdasarkan bahasa pilihan untuk alamat yang diberikan, seperti yang diidentifikasi oleh sistem.

Address Validation API mengabaikan nilai dalam recipients dan organization. Semua nilai di kolom tersebut akan dihapus dan tidak ditampilkan. Jangan tetapkan.
previousResponseId

string

Kolom ini harus kosong untuk permintaan validasi alamat pertama. Jika diperlukan lebih banyak permintaan untuk memvalidasi satu alamat sepenuhnya (misalnya jika perubahan yang dilakukan pengguna setelah validasi awal harus divalidasi ulang), setiap permintaan tindak lanjut harus mengisi kolom ini dengan responseId dari respons pertama dalam urutan validasi.
enableUspsCass

boolean

Mengaktifkan mode yang kompatibel dengan USPS CASS. Hal ini hanya memengaruhi kolom google.maps.addressvalidation.v1.ValidationResult.usps_data dari google.maps.addressvalidation.v1.ValidationResult. Catatan: untuk permintaan alamat di Puerto Riko yang mengaktifkan USPS CASS, google.type.PostalAddress.region_code dari address harus diberikan sebagai "PR", atau google.type.PostalAddress.administrative_area dari address harus diberikan sebagai "Puerto Rico" (tidak peka huruf besar/kecil) atau "PR".

Sebaiknya gunakan address yang dikomposisikan, atau tentukan minimal dua google.type.PostalAddress.address_lines dengan baris pertama berisi nomor dan nama jalan, serta baris kedua berisi kota, negara bagian, dan kode pos.
languageOptions

object (LanguageOptions)

Opsional. Pratinjau: Fitur ini ada dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Mengaktifkan Address Validation API untuk menyertakan informasi tambahan dalam respons.
sessionToken

string

Opsional. String yang mengidentifikasi sesi Autocomplete untuk tujuan penagihan. Harus berupa string base64 yang aman untuk URL dan nama file dengan panjang maksimum 36 karakter ASCII. Jika tidak, error INVALID_ARGUMENT akan ditampilkan.

Sesi dimulai saat pengguna membuat kueri Autocomplete, dan berakhir saat mereka memilih tempat dan panggilan ke Place Details atau Address Validation dilakukan. Setiap sesi dapat memiliki beberapa kueri Autocomplete, diikuti dengan satu permintaan Place Details atau Address Validation. Kredensial yang digunakan untuk setiap permintaan dalam sesi harus berasal dari project Konsol Google Cloud yang sama. Setelah sesi selesai, token tidak lagi valid; aplikasi Anda harus menghasilkan token baru untuk setiap sesi. Jika parameter sessionToken dihilangkan, atau jika Anda menggunakan kembali token sesi, sesi tersebut dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah).

Catatan: Address Validation hanya dapat digunakan dalam sesi dengan Autocomplete (New) API, bukan Autocomplete API. Lihat https://developers.google.com/maps/documentation/places/web-service/session-pricing untuk mengetahui detail selengkapnya.

Isi respons

Respons terhadap permintaan validasi alamat.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "result": {
    object (ValidationResult)
  },
  "responseId": string
}
Kolom
result

object (ValidationResult)

Hasil validasi alamat.
responseId

string

UUID yang mengidentifikasi respons ini. Jika alamat perlu divalidasi ulang, UUID ini harus menyertai permintaan baru.

PostalAddress

Merepresentasikan alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Seperti alamat pos, layanan pos dapat mengirimkan item ke tempat, P.O Box, atau yang serupa. Ini tidak dimaksudkan untuk memodelkan lokasi geografis (jalan, kota, gunung).

Dalam penggunaan umum, alamat akan dibuat melalui input pengguna atau dengan mengimpor data yang ada, bergantung pada jenis prosesnya.

Saran tentang pengisian/pengeditan alamat: - Gunakan widget alamat yang siap untuk internasionalisasi seperti https://github.com/google/libaddressinput) - Pengguna tidak boleh diberi elemen UI untuk mengisi atau mengedit kolom selain negara tempat kolom tersebut digunakan.

Untuk mendapatkan panduan lebih lanjut tentang cara menggunakan skema ini, lihat: https://support.google.com/business/answer/6397478

Representasi JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Kolom
revision

integer

Revisi skema PostalAddress. Nilai apa pun selain 0 akan menyebabkan API menampilkan error INVALID_ARGUMENT.
regionCode

string

Opsional. Kode wilayah CLDR negara/wilayah alamat. Lihat https://cldr.unicode.org/ dan https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk detailnya. Contoh: "CH" untuk Swiss. Jika tidak disediakan, kode wilayah akan disimpulkan dari alamat. Untuk performa terbaik, sebaiknya sertakan kode wilayah jika Anda mengetahuinya. Memiliki wilayah yang tidak konsisten atau berulang dapat menyebabkan performa yang buruk, misalnya, jika addressLines sudah menyertakan wilayah, jangan berikan kode wilayah lagi di kolom ini. Wilayah yang didukung dapat ditemukan di FAQ.
languageCode

string

Kode bahasa di alamat input dicadangkan untuk penggunaan di masa mendatang dan diabaikan saat ini. API menampilkan alamat dalam bahasa yang sesuai untuk lokasi alamat tersebut.
postalCode

string

Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan penyertaan kode pos, tetapi jika kode pos digunakan, kode pos dapat memicu validasi tambahan dengan bagian alamat lain (mis. validasi negara bagian/kode pos di AS).
sortingCode

string

Opsional. Kode pengurutan tambahan khusus negara. Kode ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilai dapat berupa string seperti "CEDEX", secara opsional diikuti dengan angka (mis. "CEDEX 7"), atau hanya angka saja, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (mis. Côte d'Ivoire).
administrativeArea

string

Opsional. Subdivisi administratif tertinggi yang digunakan untuk alamat pos negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Khususnya, untuk Spanyol ini adalah provinsi dan bukan komunitas otonom (mis. "Barcelona" dan bukan "Catalunya"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Mis. di Swiss ini harus dibiarkan kosong.
locality

string

Opsional. Secara umum merujuk pada bagian kota dari alamat tersebut. Contoh: US city, IT comune, UK post town. Di wilayah dunia dengan lokalitas yang tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, biarkan lokalitas kosong dan gunakan addressLines.
sublocality

string

Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa lingkungan, borough, distrik.
addressLines[]

string

Wajib. Baris alamat tidak terstruktur yang menggambarkan level alamat yang lebih rendah.

Karena nilai dalam addressLines tidak memiliki informasi jenis dan terkadang dapat berisi beberapa nilai dalam satu kolom (misalnya "Austin, TX"), urutan baris haruslah jelas. Urutan baris alamat harus berupa "urutan amplop" untuk negara/wilayah alamat.

Representasi struktural minimum yang diizinkan dari alamat terdiri dari semua informasi yang ditempatkan di addressLines. Jika regionCode tidak diberikan, region akan diambil dari baris alamat.

Membuat alamat yang hanya berisi addressLines, lalu melakukan geocoding adalah cara yang direkomendasikan untuk menangani alamat yang sepenuhnya tidak terstruktur (sebagai kebalikan dari menebak bagian alamat yang harus berupa lokalitas atau wilayah administratif).
recipients[]

string

Jangan menetapkan kolom ini. Address Validation API saat ini tidak menggunakannya. Meskipun saat ini API tidak akan menolak permintaan dengan kolom ini ditetapkan, informasi akan dihapus dan tidak akan ditampilkan dalam respons.
organization

string

Jangan menetapkan kolom ini. Address Validation API saat ini tidak menggunakannya. Meskipun saat ini API tidak akan menolak permintaan dengan kolom ini ditetapkan, informasi akan dihapus dan tidak akan ditampilkan dalam respons.

LanguageOptions

Pratinjau: Fitur ini sedang dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Memungkinkan Address Validation API menyertakan informasi tambahan dalam respons.

Representasi JSON 
{
  "returnEnglishLatinAddress": boolean
}
Kolom
returnEnglishLatinAddress

boolean

Pratinjau: Menampilkan google.maps.addressvalidation.v1.Address dalam bahasa Inggris. Untuk lebih detailnya, lihat google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

ValidationResult

Hasil validasi alamat.

Representasi JSON 
{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}
Kolom
verdict

object (Verdict)

Flag verdict keseluruhan
address

object (Address)

Informasi tentang alamat itu sendiri, bukan geocode.
geocode

object (Geocode)

Informasi tentang lokasi dan tempat yang di-geocoding alamatnya.
metadata

object (AddressMetadata)

Informasi lainnya yang relevan dengan pengiriman. metadata tidak dijamin akan terisi penuh untuk setiap alamat yang dikirim ke Address Validation API.
uspsData

object (UspsData)

Flag ketersampaian tambahan yang disediakan oleh USPS. Hanya disediakan di wilayah US dan PR.
englishLatinAddress

object (Address)

Pratinjau: Fitur ini ada dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Alamat yang diterjemahkan ke dalam bahasa Inggris.

Alamat yang diterjemahkan tidak dapat digunakan kembali sebagai input API. Layanan menyediakannya agar pengguna dapat menggunakan bahasa ibu mereka untuk mengonfirmasi atau menolak validasi alamat yang diberikan awalnya.

Jika bagian alamat tidak memiliki terjemahan bahasa Inggris, layanan akan menampilkan bagian tersebut dalam bahasa alternatif yang menggunakan skrip Latin. Lihat di sini untuk mengetahui penjelasan tentang cara memilih bahasa alternatif. Jika bagian alamat tidak memiliki terjemahan atau transliterasi dalam bahasa yang menggunakan aksara Latin, layanan akan menampilkan bagian tersebut dalam bahasa lokal yang terkait dengan alamat.

Aktifkan output ini menggunakan tanda google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

Catatan: kolom google.maps.addressvalidation.v1.Address.unconfirmed_component_types di englishLatinAddress dan kolom google.maps.addressvalidation.v1.AddressComponent.confirmation_level di englishLatinAddress.address_components tidak diisi.

Putusan

Ringkasan lengkap hasil validasi alamat dan geocode.

Representasi JSON 
{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}
Kolom
inputGranularity

enum (Granularity)

Tingkat perincian alamat input. Ini adalah hasil penguraian alamat input dan tidak memberikan sinyal validasi apa pun. Untuk sinyal validasi, lihat validationGranularity di bawah.

Misalnya, jika alamat input menyertakan nomor apartemen tertentu, inputGranularity di sini adalah SUB_PREMISE. Jika kami tidak dapat mencocokkan nomor apartemen dalam database atau nomor apartemen tidak valid, validationGranularity kemungkinan akan menjadi PREMISE atau di bawahnya.
validationGranularity

enum (Granularity)

Tingkat perincian yang dapat digunakan API untuk memvalidasi alamat sepenuhnya. Misalnya, validationGranularity dari PREMISE menunjukkan bahwa semua komponen alamat pada tingkat PREMISE atau lebih kasar dapat divalidasi.

Hasil validasi per komponen alamat dapat ditemukan di google.maps.addressvalidation.v1.Address.address_components.
geocodeGranularity

enum (Granularity)

Informasi tentang tingkat perincian geocode. Hal ini dapat dipahami sebagai makna semantik tentang seberapa kasar atau halus lokasi yang di-geocode.

Nilai ini terkadang dapat berbeda dari validationGranularity di atas. Misalnya, database kami mungkin mencatat keberadaan nomor apartemen, tetapi tidak memiliki lokasi yang tepat untuk apartemen tersebut dalam kompleks apartemen besar. Dalam hal ini, validationGranularity akan menjadi SUB_PREMISE, tetapi geocodeGranularity akan menjadi PREMISE.
addressComplete

boolean

Alamat dianggap lengkap jika tidak ada token yang belum terselesaikan, tidak ada komponen alamat yang tidak terduga atau hilang. Jika tidak disetel, nilai tersebut akan menunjukkan bahwa nilainya adalah false. Lihat kolom missingComponentTypes, unresolvedTokens, atau unexpected untuk mengetahui detail selengkapnya.
hasUnconfirmedComponents

boolean

Setidaknya satu komponen alamat tidak dapat dikategorikan atau divalidasi, lihat google.maps.addressvalidation.v1.Address.address_components untuk mengetahui detailnya.
hasInferredComponents

boolean

Setidaknya satu komponen alamat disimpulkan (ditambahkan) yang tidak ada dalam input. Lihat google.maps.addressvalidation.v1.Address.address_components untuk mengetahui detailnya.
hasReplacedComponents

boolean

Setidaknya satu komponen alamat diganti, lihat google.maps.addressvalidation.v1.Address.address_components untuk mengetahui detailnya.

Perincian

Berbagai tingkat perincian yang dapat dimiliki alamat atau geocode. Jika digunakan untuk menunjukkan tingkat perincian alamat, nilai ini menunjukkan tingkat perincian alamat yang mengidentifikasi tujuan pengiriman. Misalnya, alamat seperti "123 Main Street, Redwood City, CA, 94061" mengidentifikasi PREMISE, sedangkan alamat seperti "Redwood City, CA, 94061" mengidentifikasi LOCALITY. Namun, jika kita tidak dapat menemukan geocode untuk "123 Main Street" di Redwood City, geocode yang ditampilkan mungkin berupa perincian LOCALITY meskipun alamatnya lebih terperinci.

Enum
GRANULARITY_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
SUB_PREMISE Hasil di bawah tingkat bangunan, seperti apartemen.
PREMISE Hasil tingkat bangunan.
PREMISE_PROXIMITY Geocode yang mendekati lokasi tingkat gedung dari alamat.
BLOCK Alamat atau geocode menunjukkan blok. Hanya digunakan di wilayah yang memiliki alamat tingkat blok, seperti Jepang.
ROUTE Geocode atau alamat bersifat terperinci untuk rute, seperti jalan, jalan raya, atau jalan tol.
OTHER Semua perincian lainnya, yang dikelompokkan bersama karena tidak dapat dihasilkan.

Alamat

Detail alamat setelah diproses. Pascapemrosesan mencakup memperbaiki bagian alamat yang salah eja, mengganti bagian yang salah, dan menyimpulkan bagian yang hilang.

Representasi JSON 
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
Kolom
formattedAddress

string

Alamat pascapemrosesan, yang diformat sebagai alamat satu baris dengan mengikuti aturan pemformatan alamat di wilayah tempat alamat tersebut berada.

Catatan: format alamat ini mungkin tidak cocok dengan format alamat di kolom postalAddress. Misalnya, postalAddress selalu mewakili negara sebagai regionCode 2 huruf, seperti "US" atau "NZ". Sebaliknya, kolom ini menggunakan bentuk nama negara yang lebih panjang, seperti "USA" atau "New Zealand".
postalAddress

object (PostalAddress)

Alamat pascapemrosesan yang diwakili sebagai alamat pos.
addressComponents[]

object (AddressComponent)

Daftar yang tidak diurutkan. Komponen alamat individual dari alamat yang diformat dan dikoreksi, beserta informasi validasi. Ini memberikan informasi tentang status validasi setiap komponen.

Komponen alamat tidak diurutkan dengan cara tertentu. Jangan membuat asumsi apa pun tentang urutan komponen alamat dalam daftar.
missingComponentTypes[]

string

Jenis komponen yang diharapkan ada dalam alamat surat yang diformat dengan benar, tetapi tidak ditemukan dalam input DAN tidak dapat disimpulkan. Komponen jenis ini tidak ada di formattedAddress, postalAddress, atau addressComponents. Contohnya adalah ['street_number', 'route'] untuk input seperti "Boulder, Colorado, 80301, USA". Daftar kemungkinan jenis dapat ditemukan di sini.
unconfirmedComponentTypes[]

string

Jenis komponen yang ada di addressComponents, tetapi tidak dapat dikonfirmasi kebenarannya. Kolom ini disediakan demi kenyamanan: kontennya setara dengan melakukan iterasi melalui addressComponents untuk menemukan jenis semua komponen yang confirmationLevel bukan CONFIRMED atau flag inferred tidak disetel ke true. Daftar kemungkinan jenis dapat ditemukan di sini.
unresolvedTokens[]

string

Token apa pun dalam input yang tidak dapat di-resolve. Ini mungkin merupakan input yang tidak dikenali sebagai bagian alamat yang valid. Misalnya, untuk input seperti "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US", token yang tidak terselesaikan mungkin terlihat seperti ["Parcel", "0000123123", "&", "0000456456"].

AddressComponent

Mewakili komponen alamat, seperti jalan, kota, atau negara bagian.

Representasi JSON 
{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}
Kolom
componentName

object (ComponentName)

Nama untuk komponen ini.
componentType

string

Jenis komponen alamat. Lihat Tabel 2: Jenis tambahan yang ditampilkan oleh layanan Places untuk daftar kemungkinan jenis.
confirmationLevel

enum (ConfirmationLevel)

Menunjukkan tingkat kepastian yang kita miliki bahwa komponen tersebut sudah benar.
inferred

boolean

Menunjukkan bahwa komponen tersebut bukan bagian dari input, tetapi kami menyimpulkannya untuk lokasi alamat dan yakin bahwa komponen tersebut harus diberikan untuk alamat yang lengkap.
spellCorrected

boolean

Menunjukkan koreksi pada kesalahan ejaan dalam nama komponen. API tidak selalu menandai perubahan dari satu varian ejaan ke varian ejaan lainnya, seperti saat mengubah "centre" menjadi "center". Fitur ini juga tidak selalu menandai kesalahan ejaan umum, seperti saat mengubah "Amphitheater Pkwy" menjadi "Amphitheatre Pkwy".
replaced

boolean

Menunjukkan bahwa nama komponen diganti dengan nama yang sama sekali berbeda, misalnya kode pos yang salah diganti dengan kode pos yang benar untuk alamat. Ini bukan perubahan kosmetik, komponen input telah diubah menjadi komponen yang berbeda.
unexpected

boolean

Menunjukkan komponen alamat yang tidak diharapkan ada di alamat pos untuk wilayah tertentu. Kami mempertahankannya hanya karena merupakan bagian dari input.

ComponentName

Wrapper untuk nama komponen.

Representasi JSON 
{
  "text": string,
  "languageCode": string
}
Kolom
text

string

Teks nama. Misalnya, "5th Avenue" untuk nama jalan atau "1253" untuk nomor jalan.
languageCode

string

Kode bahasa BCP-47. Ini tidak akan ada jika nama komponen tidak dikaitkan dengan bahasa, seperti nomor jalan.

ConfirmationLevel

Berbagai kemungkinan nilai untuk tingkat konfirmasi.

Enum
CONFIRMATION_LEVEL_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
CONFIRMED Kami dapat memverifikasi bahwa komponen ini ada dan masuk akal dalam konteks alamat lainnya.
UNCONFIRMED_BUT_PLAUSIBLE Komponen ini tidak dapat dikonfirmasi, tetapi kemungkinan komponen ini ada. Misalnya, nomor jalan dalam rentang angka valid yang diketahui di sebuah jalan yang tidak memiliki nomor rumah tertentu.
UNCONFIRMED_AND_SUSPICIOUS Komponen ini tidak dikonfirmasi dan kemungkinan salah. Misalnya, lingkungan yang tidak sesuai dengan informasi alamat lainnya.

Geocode

Berisi informasi tentang tempat input di-geocode.

Representasi JSON 
{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}
Kolom
location

object (LatLng)

Lokasi input yang di-geocoding.

Penggunaan ID tempat lebih disukai daripada penggunaan alamat, koordinat lintang/bujur, atau plus code. Menggunakan koordinat saat membuat rute atau menghitung rute mobil akan selalu menyebabkan titik disambungkan ke jalan terdekat dengan koordinat tersebut. Jalan ini mungkin bukan jalan yang akan menuju ke tujuan dengan cepat atau aman serta mungkin tidak berada di dekat titik akses ke properti. Selain itu, saat lokasi di-geocoding balik, tidak ada jaminan bahwa alamat yang ditampilkan akan cocok dengan alamat asli.
plusCode

object (PlusCode)

Plus Codes yang sesuai dengan location.
bounds

object (Viewport)

Batas tempat yang di-geocoding.
featureSizeMeters

number

Ukuran tempat yang di-geocoding, dalam meter. Ini adalah ukuran lain dari kekasaran lokasi yang digeocode, tetapi dalam ukuran fisik, bukan dalam makna semantik.
placeId

string

PlaceID tempat yang di-geocoding oleh input ini.

Untuk informasi selengkapnya tentang ID Tempat, lihat di sini.
placeTypes[]

string

Jenis tempat yang di-geocoding input. Misalnya, ['locality', 'political']. Daftar lengkap jenis dapat ditemukan di sini.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Ini dinyatakan sebagai pasangan nilai ganda untuk mewakili derajat lintang dan derajat bujur. Kecuali jika ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

PlusCode

Plus Codes (http://plus.codes) adalah referensi lokasi dengan dua format: kode global yang menentukan persegi panjang 14mx14m (1/8000 derajat) atau lebih kecil, dan kode gabungan, yang mengganti awalan dengan lokasi referensi.

Representasi JSON 
{
  "globalCode": string,
  "compoundCode": string
}
Kolom
globalCode

string

Kode global (lengkap) tempat, seperti "9FWM33GV+HQ", yang mewakili area 1/8000 derajat x 1/8000 derajat (~14 x 14 meter).
compoundCode

string

Kode gabungan tempat, seperti "33GV+HQ, Ramberg, Norway", yang berisi akhiran kode global dan mengganti awalan dengan nama entitas referensi yang diformat.

Area Pandang

Area tampilan lintang-bujur, direpresentasikan sebagai dua titik yang berlawanan secara diagonal dengan low dan high. Area pandang dianggap sebagai wilayah tertutup, yaitu mencakup batasnya. Batas lintang harus berkisar antara -90 hingga 90 derajat inklusif, dan batas bujur harus berkisar antara -180 hingga 180 derajat inklusif. Berbagai kasus meliputi:

  • Jika low = high, area pandang terdiri dari titik tunggal tersebut.

  • Jika low.longitude > high.longitude, rentang bujur akan terbalik (area pandang melintasi garis bujur 180 derajat).

  • Jika low.longitude = -180 derajat dan high.longitude = 180 derajat, area pandang akan menyertakan semua bujur.

  • Jika low.longitude = 180 derajat dan high.longitude = -180 derajat, rentang bujur akan kosong.

  • Jika low.latitude > high.latitude, rentang lintang akan kosong.

low dan high harus diisi, dan kotak yang direpresentasikan tidak boleh kosong (seperti yang ditentukan oleh definisi di atas). Area pandang kosong akan menyebabkan error.

Misalnya, area pandang ini sepenuhnya mencakup New York City:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Representasi JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Kolom
low

object (LatLng)

Wajib. Titik terendah area pandang.
high

object (LatLng)

Wajib. Titik tertinggi area pandang.

AddressMetadata

Metadata untuk alamat. metadata tidak dijamin akan terisi sepenuhnya untuk setiap alamat yang dikirim ke Address Validation API.

Representasi JSON 
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
Kolom
business

boolean

Menunjukkan bahwa ini adalah alamat bisnis. Jika tidak ditetapkan, menunjukkan bahwa nilainya tidak diketahui.
poBox

boolean

Menunjukkan bahwa alamat tersebut adalah kotak pos. Jika tidak disetel, nilai akan menunjukkan bahwa nilai tidak diketahui.
residential

boolean

Menunjukkan bahwa ini adalah alamat tempat tinggal. Jika tidak ditetapkan, menunjukkan bahwa nilainya tidak diketahui.

UspsData

Data USPS untuk alamat. uspsData tidak dijamin akan terisi sepenuhnya untuk setiap alamat AS atau PR yang dikirim ke Address Validation API. Sebaiknya integrasikan kolom alamat cadangan dalam respons jika Anda menggunakan uspsData sebagai bagian utama respons.

Representasi JSON 
{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}
Kolom
standardizedAddress

object (UspsAddress)

alamat standar USPS.
deliveryPointCode

string

Kode titik pengiriman 2 digit
deliveryPointCheckDigit

string

Digit periksa titik pengiriman. Nomor ini ditambahkan ke akhir delivery_point_barcode untuk surat yang dipindai secara mekanis. Menambahkan semua digit delivery_point_barcode, deliveryPointCheckDigit, kode pos, dan ZIP+4 akan menghasilkan angka yang habis dibagi 10.
dpvConfirmation

string

Kemungkinan nilai untuk konfirmasi DPV. Menampilkan satu karakter atau tidak menampilkan nilai.

  • N: Informasi nomor utama dan sekunder gagal dikonfirmasi DPV.
  • D: Alamat dikonfirmasi DPV hanya untuk nomor utama, dan informasi nomor sekunder tidak ada.
  • S: Alamat dikonfirmasi DPV hanya untuk nomor utama, dan informasi nomor sekunder ada, tetapi tidak dikonfirmasi.
  • Y: Alamat dikonfirmasi DPV untuk nomor utama dan sekunder.
  • Kosong: Jika respons tidak berisi nilai dpvConfirmation, alamat tidak dikirim untuk konfirmasi DPV.
dpvFootnote

string

Catatan kaki dari validasi titik pengiriman. Beberapa catatan kaki dapat dirangkai dalam string yang sama.

  • AA: Alamat input yang cocok dengan file ZIP+4
  • A1: Alamat input tidak cocok dengan file ZIP+4
  • BB: Cocok dengan DPV (semua komponen)
  • CC: Nomor sekunder tidak cocok dan tidak diperlukan
  • C1: Nomor sekunder tidak cocok, tetapi wajib diisi
  • N1: Alamat bertingkat tinggi tidak memiliki nomor sekunder
  • M1: Nomor utama tidak ada
  • M3: Nomor utama tidak valid
  • P1: Nomor kotak PO, RR, atau HC alamat input tidak ada
  • P3: Nomor PO, RR, atau HC Box alamat input tidak valid
  • F1: Alamat input yang cocok dengan alamat militer
  • G1: Alamat input yang cocok dengan alamat pengiriman umum
  • U1: Alamat input yang cocok dengan kode pos unik
  • PB: Alamat input yang cocok dengan data PBSA
  • RR: Alamat yang dikonfirmasi DPV dengan informasi PMB
  • R1: Alamat yang dikonfirmasi DPV tanpa informasi PMB
  • R7: Data Rute Operator R777 atau R779
  • IA: Alamat yang Diinformasikan diidentifikasi
  • TA: Nomor utama dicocokkan dengan menghapus alfa di akhir
dpvCmra

string

Menunjukkan apakah alamat tersebut adalah CMRA (Commercial Mail Receiving Agency)--bisnis pribadi yang menerima surat untuk klien. Menampilkan satu karakter.

  • Y: Alamatnya adalah CMRA
  • N: Alamat bukan CMRA
dpvVacant

string

Apakah tempat ini kosong? Menampilkan satu karakter.

  • Y: Alamat kosong
  • N: Alamat tidak kosong
dpvNoStat

string

Apakah ini alamat tanpa statistik atau alamat aktif? Alamat tanpa statistik adalah alamat yang tidak terus-menerus digunakan atau alamat yang tidak dilayani oleh USPS. Menampilkan satu karakter.

  • Y: Alamat tidak aktif
  • N: Alamat aktif
dpvNoStatReasonCode

integer

Menunjukkan jenis NoStat. Menampilkan kode alasan sebagai int.

  • 1: IDA (Internal Drop Address) – Alamat yang tidak menerima surat langsung dari USPS, tetapi dikirim ke alamat drop yang melayaninya.
  • 2: CDS - Alamat yang belum dapat dikirim. Misalnya, subdivisi baru yang lot dan nomor utamanya telah ditentukan, tetapi belum ada struktur untuk penghuni.
  • 3: Tabrakan - Alamat yang sebenarnya tidak mengonfirmasi DPV.
  • 4: CMZ (College, Military, and Other Types) - Data ZIP + 4 yang telah digabungkan USPS.
  • 5: Biasa - Menunjukkan alamat yang tidak menerima pengiriman dan alamat tersebut tidak dihitung sebagai kemungkinan pengiriman.
  • 6: Sekunder Wajib - Alamat memerlukan informasi sekunder.
dpvDrop

string

Tanda menunjukkan bahwa email dikirim ke satu penerima di situs. Menampilkan satu karakter.

  • Y: Email dikirim ke satu penerima di sebuah situs.
  • N: Email tidak dikirim ke satu kotak surat di situs.
dpvThrowback

string

Menunjukkan bahwa surat tidak dikirim ke alamat jalan. Menampilkan satu karakter.

  • Y: Surat tidak dikirim ke alamat.
  • N: Surat akan dikirim ke alamat.
dpvNonDeliveryDays

string

Tanda menunjukkan bahwa pengiriman email tidak dilakukan setiap hari dalam seminggu. Menampilkan satu karakter.

  • Y: Pengiriman surat tidak dilakukan setiap hari dalam seminggu.
  • N: Tidak ada indikasi bahwa pengiriman surat tidak dilakukan setiap hari dalam seminggu.
dpvNonDeliveryDaysValues

integer

Bilangan bulat yang mengidentifikasi hari gagal tayang. Flag ini dapat diinterogasi menggunakan flag bit: 0x40 – Minggu adalah hari tanpa pengiriman 0x20 – Senin adalah hari tanpa pengiriman 0x10 – Selasa adalah hari tanpa pengiriman 0x08 – Rabu adalah hari tanpa pengiriman 0x04 – Kamis adalah hari tanpa pengiriman 0x02 – Jumat adalah hari tanpa pengiriman 0x01 – Sabtu adalah hari tanpa pengiriman
dpvNoSecureLocation

string

Tanda menunjukkan pintu dapat diakses, tetapi paket tidak akan ditinggalkan karena masalah keamanan. Menampilkan satu karakter.

  • Y: Paket tidak akan dibiarkan karena masalah keamanan.
  • N: Tidak ada indikasi bahwa paket tidak akan ditinggalkan karena masalah keamanan.
dpvPbsa

string

Menunjukkan bahwa alamat cocok dengan data PBSA. Menampilkan satu karakter.

  • Y: Alamat cocok dengan data PBSA.
  • N: Alamat tidak cocok dengan data PBSA.
dpvDoorNotAccessible

string

Tanda menunjukkan alamat tempat USPS tidak dapat mengetuk pintu untuk mengantarkan surat. Menampilkan satu karakter.

  • Y: Pintu tidak dapat diakses.
  • N: Tidak ada indikasi bahwa pintu tidak dapat diakses.
dpvEnhancedDeliveryCode

string

Menunjukkan bahwa lebih dari satu kode pengembalian DPV valid untuk alamat tersebut. Menampilkan satu karakter.

  • Y: Alamat dikonfirmasi DPV untuk nomor utama dan sekunder.
  • N: Informasi nomor utama dan sekunder gagal dikonfirmasi DPV.
  • S: Alamat dikonfirmasi DPV hanya untuk nomor utama, dan informasi nomor sekunder ada tetapi tidak dikonfirmasi, atau satu alfa di akhir nomor utama dihapus untuk membuat kecocokan DPV dan informasi sekunder diperlukan.
  • D: Alamat dikonfirmasi DPV hanya untuk nomor utama, dan informasi nomor sekunder tidak ada.
  • R: Alamat dikonfirmasi, tetapi ditetapkan ke rute phantom R777 dan R779, dan pengiriman USPS tidak disediakan.
carrierRoute

string

Kode rute operator. Kode empat karakter yang terdiri dari awalan satu huruf dan penanda rute tiga digit.

Awalan:

  • C: Rute ekspedisi (atau rute kota)
  • R: Rute pedesaan
  • H: Rute Kontrak Jalan Raya
  • B: Bagian Kotak Kantor Pos
  • G: Unit pengiriman umum
carrierRouteIndicator

string

Indikator pengurutan tarif rute ekspedisi.
ewsNoMatch

boolean

Alamat pengiriman dapat dicocokkan, tetapi file EWS menunjukkan bahwa kecocokan persis akan segera tersedia.
postOfficeCity

string

Kota kantor pos utama.
postOfficeState

string

Negara bagian utama kantor pos.
abbreviatedCity

string

Kota singkatan.
fipsCountyCode

string

Kode county FIPS.
county

string

Nama county.
elotNumber

string

Nomor Enhanced Line of Travel (eLOT).
elotFlag

string

Flag eLOT Naik/Turun (A/D).
poBoxOnlyPostalCode

boolean

Kode pos khusus Kotak Pos.
pmbDesignator

string

Penunjuk unit PMB (Private Mail Box).
pmbNumber

string

Nomor PMB (Kotak Surat Pribadi);
addressRecordType

string

Jenis data alamat yang cocok dengan alamat input.

  • F: FIRM. Ini adalah kecocokan dengan Data Perusahaan, yang merupakan tingkat kecocokan terbaik yang tersedia untuk alamat.
  • G: PENGIRIMAN UMUM. Ini cocok dengan data Pengiriman Umum.
  • H: GEDUNG / APARTEMEN. Ini cocok dengan data Bangunan atau Apartemen.
  • P: POST OFFICE BOX. Ini cocok dengan Kotak Pos.
  • R: RURAL ROUTE atau HIGHWAY CONTRACT: Ini adalah kecocokan dengan data Rural Route atau Highway Contract, yang keduanya mungkin memiliki rentang Nomor Kotak terkait.
  • S: DATA JALAN: Ini adalah kecocokan dengan data Jalan yang berisi rentang nomor utama yang valid.
defaultAddress

boolean

Indikator bahwa alamat default ditemukan, tetapi ada alamat yang lebih spesifik.
errorMessage

string

Pesan error untuk pengambilan data USPS. Kolom ini diisi saat pemrosesan USPS ditangguhkan karena deteksi alamat yang dibuat secara artifisial.

Kolom data USPS mungkin tidak diisi saat error ini ada.
cassProcessed

boolean

Indikator bahwa permintaan telah diproses CASS.

UspsAddress

Representasi USPS dari alamat AS.

Representasi JSON 
{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}
Kolom
firstAddressLine

string

Baris alamat pertama.
firm

string

Nama firma.
secondAddressLine

string

Baris alamat kedua.
urbanization

string

Nama urbanisasi Puerto Riko.
cityStateZipAddressLine

string

Kota + negara bagian + kode pos.
city

string

Nama kota.
state

string

Kode negara bagian 2 huruf.
zipCode

string

Kode pos, misalnya, 10009.
zipCodeExtension

string

Ekstensi kode pos 4 digit, misalnya 5023.