Memberi geocode pada suatu tempat

Developer Wilayah Ekonomi Eropa (EEA)

Geocoding tempat memungkinkan Anda mengambil alamat dari ID tempat.

ID tempat secara unik mengidentifikasi tempat di database Google Places dan Google Maps. Ambil ID tempat saat Anda Geocode an address. Anda juga dapat mengambil ID tempat dari banyak API lainnya, seperti Detail Tempat (Baru), Penelusuran Teks (Baru), dan Penelusuran Terdekat (Baru).

Permintaan geocoding tempat

Permintaan geocoding tempat adalah permintaan HTTP GET dalam bentuk:

https://geocode.googleapis.com/v4/geocode/places/PLACE_ID

Dengan PLACE_ID berisi ID tempat lokasi minat.

Teruskan semua parameter lainnya sebagai parameter URL atau, untuk parameter seperti kunci API atau mask kolom, di header sebagai bagian dari permintaan GET. Contoh:

https://geocode.googleapis.com/v4/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?key=API_KEY

Atau dalam perintah curl:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
"https://geocode.googleapis.com/v4/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw"

Menggunakan OAuth untuk membuat permintaan

Geocoding API v4 mendukung OAuth 2.0 untuk autentikasi. Untuk menggunakan OAuth dengan Geocoding API, token OAuth harus diberi cakupan yang benar. Geocoding API mendukung cakupan berikut untuk digunakan dengan geocoding tempat:

  • https://www.googleapis.com/auth/maps-platform.geocode — Gunakan dengan semua metode Geocoding API.
  • https://www.googleapis.com/auth/maps-platform.geocode.place — Hanya gunakan dengan GeocodePlace untuk geocoding tempat.

Selain itu, Anda dapat menggunakan cakupan https://www.googleapis.com/auth/cloud-platform umum untuk semua metode Geocoding API. Cakupan tersebut berguna selama pengembangan, tetapi tidak untuk produksi, karena cakupan tersebut adalah cakupan umum yang memungkinkan akses ke semua metode.

Untuk mengetahui informasi dan contoh selengkapnya, lihat Menggunakan OAuth.

Respons geocoding tempat

Geocoding tempat menampilkan GeocodeResult objek yang mewakili tempat yang sesuai dengan ID tempat.

Respons Geocoding API mencakup types array di dua tempat utama dalam GeocodeResult:

  1. GeocodeResult.types: Array ini menunjukkan jenis hasil secara keseluruhan. Nilai yang mungkin diambil dari Tabel A dan Tabel B di halaman Jenis Tempat (Baru).
  2. GeocodeResult.addressComponents[].types: Setiap komponen alamat memiliki types array yang menunjukkan jenis bagian alamat tertentu. Nilai ini diambil dari tabel Jenis alamat dan jenis komponen alamat di halaman Jenis Tempat (Baru).

Objek JSON lengkap dalam bentuk:

{
  "place": "//places.googleapis.com/places/ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "placeId": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "location": {
    "latitude": 37.4220541,
    "longitude": -122.08532419999999
  },
  "granularity": "ROOFTOP",
  "viewport": {
    "low": {
      "latitude": 37.4209489697085,
      "longitude": -122.08846930000001
    },
    "high": {
      "latitude": 37.4236469302915,
      "longitude": -122.0829156
    }
  },
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "postalAddress": {
    "regionCode": "US",
    "languageCode": "en",
    "postalCode": "94043",
    "administrativeArea": "CA",
    "locality": "Mountain View",
    "addressLines": [
      "1600 Amphitheatre Pkwy"
    ]
  },
  "addressComponents": [
    {
      "longText": "1600",
      "shortText": "1600",
      "types": [
        "street_number"
      ]
    },
    {
      "longText": "Amphitheatre Parkway",
      "shortText": "Amphitheatre Pkwy",
      "types": [
        "route"
      ],
      "languageCode": "en"
    },
    {
      "longText": "Mountain View",
      "shortText": "Mountain View",
      "types": [
        "locality",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "Santa Clara County",
      "shortText": "Santa Clara County",
      "types": [
        "administrative_area_level_2",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "California",
      "shortText": "CA",
      "types": [
        "administrative_area_level_1",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "United States",
      "shortText": "US",
      "types": [
        "country",
        "political"
      ],
      "languageCode": "en"
    },
    {
      "longText": "94043",
      "shortText": "94043",
      "types": [
        "postal_code"
      ]
    }
  ],
  "types": [
    "establishment",
    "point_of_interest"
  ]
}

Parameter yang diperlukan

  • place — ID tempat yang alamatnya ingin Anda dapatkan dalam format yang dapat dibaca manusia. ID tempat adalah sebuah ID unik identifier yang dapat digunakan bersama Google API lainnya. Misalnya, Anda dapat menggunakan placeID yang ditampilkan oleh Roads API untuk mendapatkan alamat titik yang telah diikat. Untuk mengetahui informasi selengkapnya tentang ID tempat, lihat ID Tempat.

Parameter opsional

  • languageCode

    Bahasa yang digunakan untuk menampilkan hasil.

    • Lihat daftar bahasa yang didukung. Google sering memperbarui bahasa yang didukung, sehingga daftar ini tidak selalu lengkap.
    • Jika languageCode tidak diberikan, API akan menggunakan en sebagai default. Jika Anda menentukan kode bahasa yang tidak valid, API akan menampilkan error INVALID_ARGUMENT.
    • API akan berupaya sebaik mungkin untuk memberikan alamat jalan yang dapat dibaca oleh pengguna dan penduduk setempat. Untuk mencapai tujuan tersebut, API akan menampilkan alamat jalan dalam bahasa lokal, yang ditransliterasi ke skrip yang dapat dibaca oleh pengguna jika diperlukan, dengan memperhatikan bahasa pilihan. Semua alamat lainnya ditampilkan dalam bahasa pilihan. Semua komponen alamat ditampilkan dalam bahasa yang sama, yang dipilih dari komponen pertama.
    • Jika nama tidak tersedia dalam bahasa pilihan, API akan menggunakan kecocokan terdekat.
    • Bahasa pilihan memiliki pengaruh kecil pada kumpulan hasil yang dipilih API untuk ditampilkan, dan urutan hasil tersebut ditampilkan. Geocoder menafsirkan singkatan secara berbeda bergantung pada bahasa, seperti singkatan untuk jenis jalan, atau sinonim yang mungkin valid dalam satu bahasa tetapi tidak dalam bahasa lain.

  • regionCode

    Kode wilayah sebagai nilai kode CLDR dua karakter. Tidak ada nilai default. Sebagian besar kode CLDR identik dengan kode ISO 3166-1.

    Saat melakukan geocoding alamat, geocoding maju, parameter ini dapat memengaruhi, tetapi tidak sepenuhnya membatasi, hasil dari layanan ke wilayah yang ditentukan. Saat melakukan geocoding lokasi atau tempat, geocoding terbalik atau geocoding tempat, parameter ini dapat digunakan untuk memformat alamat. Dalam semua kasus, parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.

  • FieldMask

    Buat mask kolom respons untuk menentukan kolom yang akan ditampilkan dalam respons. Teruskan mask kolom respons ke metode dengan menggunakan parameter URL $fields atau fields, atau dengan menggunakan header HTTP X-Goog-FieldMask. Misalnya, permintaan di bawah ini hanya akan menampilkan kolom formattedAddress dari respons.

    curl -X GET -H 'Content-Type: application/json' \
-H 'X-Goog-FieldMask: formattedAddress' \
-H "X-Goog-Api-Key: API_KEY" \
"https://geocode.googleapis.com/v4/geocode/places/ChIJj61dQgK6j4AR4GeTYWZsKWw"
    Responsnya adalah: 
    {
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA"
}

    Lihat Memilih kolom yang akan ditampilkan untuk mengetahui detail selengkapnya.