Location

Resource yang mewakili lokasi dengan informasi geografis lengkap.

Representasi JSON 
{
  "locationType": enum (LocationType),
  "postalAddress": {
    object (PostalAddress)
  },
  "latLng": {
    object (LatLng)
  },
  "radiusMiles": number
}
Kolom
locationType

enum (LocationType)

Jenis lokasi, yang sesuai dengan kolom baris alamat google.type.PostalAddress. Misalnya, "Downtown, Atlanta, GA, USA" memiliki jenis LocationType.NEIGHBORHOOD, dan "Kansas City, KS, USA" memiliki jenis LocationType.LOCALITY.
postalAddress

object (PostalAddress)

Alamat pos lokasi yang menyertakan informasi yang dapat dibaca manusia, seperti alamat pos dan alamat pembayaran. Berdasarkan alamat pos, layanan pos dapat mengirimkan item ke lokasi, P.O. Box, atau lokasi pengiriman lainnya.
latLng

object (LatLng)

Objek yang mewakili pasangan garis lintang/garis bujur.
radiusMiles

number

Radius dalam mil dari lokasi pekerjaan. Nilai ini berasal dari kotak pembatas lokasi, tempat lingkaran dengan radius yang ditentukan yang berpusat dari google.type.LatLng mencakup area yang terkait dengan lokasi pekerjaan. Misalnya, saat ini, " Mountain View, CA, USA" memiliki radius 6,17 mil.

LocationType

Enum yang mewakili jenis lokasi.

Enum
LOCATION_TYPE_UNSPECIFIED Nilai default jika jenis tidak ditentukan.
COUNTRY Lokasi tingkat negara.
ADMINISTRATIVE_AREA Negara bagian atau lokasi tingkat yang setara.
SUB_ADMINISTRATIVE_AREA Lokasi tingkat county atau yang setara.
LOCALITY Kota atau lokasi di tingkat yang setara.
POSTAL_CODE Lokasi tingkat kode pos.
SUB_LOCALITY Sublokalitas adalah subdivisi lokalitas, misalnya kota kecil, wilayah, atau arondisemen. Sublokalitas biasanya diakui oleh otoritas politik setempat. Misalnya, Manhattan dan Brooklyn diakui sebagai kota besar oleh Kota New York, dan karenanya dimodelkan sebagai sublokalitas.
SUB_LOCALITY_1 Lokasi tingkat distrik atau yang setara.
SUB_LOCALITY_2 Tampilan tingkat distrik yang lebih kecil atau yang setara.
NEIGHBORHOOD Lokasi tingkat lingkungan.
STREET_ADDRESS Lokasi tingkat alamat.

PostalAddress

Mewakili alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Seperti alamat pos, layanan pos dapat mengirimkan item ke lokasi, P.O. Box, atau yang serupa. Aplikasi ini tidak dimaksudkan untuk membuat model lokasi geografis (jalan, kota, gunung).

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

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

Untuk 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 ini harus ditetapkan ke 0, yang merupakan revisi terbaru.

Semua revisi baru harus kompatibel dengan revisi lama.
regionCode

string

Wajib. Kode wilayah CLDR negara/wilayah alamat. Ini tidak pernah disimpulkan dan terserah pengguna untuk memastikan nilainya benar. Lihat http://cldr.unicode.org/ dan http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss.
languageCode

string

Opsional. Kode bahasa BCP-47 dari konten alamat ini (jika diketahui). Ini sering kali berupa bahasa UI formulir input atau diharapkan cocok dengan salah satu bahasa yang digunakan di negara/wilayah alamat, atau bahasa yang setara dalam transliterasinya. Hal ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak penting bagi ketepatan data dan tidak akan memengaruhi validasi atau operasi terkait non-pemformatan lainnya.

Jika nilai ini tidak diketahui, nilai ini harus dihilangkan (bukan menetapkan nilai default yang mungkin salah).

Contoh: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan keberadaan kode pos, tetapi jika digunakan, kode pos tersebut dapat memicu validasi tambahan dengan bagian alamat yang lain (misalnya validasi negara bagian/pos di Amerika Serikat).
sortingCode

string

Opsional. Kode pengurutan tambahan khusus negara. Atribut ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya berupa string seperti "CEDEX", secara opsional diikuti dengan angka (misalnya "CEDEX 7"), atau hanya angka, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (misalnya 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 (misalnya "Barcelona" dan bukan "Catalunya"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan tidak terisi.
locality

string

Opsional. Secara umum merujuk pada bagian kota dari alamat. Contoh: US city, IT comune, UK post city. 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 kawasan, kota kecil, distrik.
addressLines[]

string

Baris alamat tidak terstruktur yang menggambarkan tingkat alamat yang lebih rendah.

Karena nilai di addressLines tidak memiliki informasi jenis dan terkadang dapat berisi beberapa nilai dalam satu kolom (misalnya "Austin, TX"), urutan baris harus jelas. Urutan baris alamat harus "urutan amplop" untuk negara/wilayah alamat. Di tempat yang dapat memiliki perbedaan (mis. Jepang), address_language digunakan untuk membuatnya eksplisit (mis. "ja" untuk pengurutan besar ke kecil dan "ja-Latn" atau "en" untuk kecil ke besar). Dengan cara ini, baris alamat paling spesifik dapat dipilih berdasarkan bahasa.

Representasi struktural minimum yang diizinkan dari alamat terdiri dari regionCode dengan semua informasi yang tersisa yang ditempatkan di addressLines. Alamat tersebut dapat diformat kira-kira tanpa geocoding, tetapi tidak ada alasan semantik yang dapat dibuat untuk komponen alamat mana pun hingga setidaknya sebagian terselesaikan.

Membuat alamat yang hanya berisi regionCode dan addressLines, dan kemudian geocoding adalah cara yang disarankan untuk menangani alamat yang benar-benar tidak terstruktur (bukan menebak bagian mana dari alamat yang harus berupa lokalitas atau wilayah administratif).
recipients[]

string

Opsional. Penerima di alamat. Dalam kondisi tertentu, kolom ini dapat berisi informasi multibaris. Misalnya, halaman ini mungkin berisi informasi "perawatan".
organization

string

Opsional. Nama organisasi di alamat.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali ditentukan lain, nilai 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].