Mulai Menggunakan Geocoding API v4

Developer Wilayah Ekonomi Eropa (EEA)

Jika alamat penagihan Anda berada di Wilayah Ekonomi Eropa, mulai 8 Juli 2025, Persyaratan Layanan Google Maps Platform EEA akan berlaku untuk penggunaan Layanan oleh Anda. Fungsi bervariasi menurut wilayah. Pelajari lebih lanjut.

Sebelum memulai: Sebelum mulai menggunakan Geocoding API, Anda perlu memiliki project dengan akun penagihan dan Geocoding API yang aktif. Sebaiknya buat beberapa Project Owner dan Billing Administrator agar selalu ada seseorang yang memiliki peran ini pada tim Anda. Untuk mempelajari lebih lanjut, lihat Menyiapkan project di Konsol Cloud.

Geocoding API v4 menyediakan dua kelompok kemampuan inti: penelusuran tujuan untuk atribut hiperlokal yang lengkap, dan geocoding dasar (konversi koordinat-alamat). Tidak yakin metode mana yang akan digunakan? Lihat Memilih metode geocoding.

• Menelusuri tujuan (SearchDestinations): Mengambil detail kedatangan yang lengkap untuk suatu tujuan—termasuk pintu masuk bangunan, titik navigasi yang dapat dirutekan, garis batas bangunan/tanah, sub-tujuan, dan tempat terkenal di sekitar.
• Geocoding (GeocodeAddress): Mengonversi alamat menjadi koordinat lintang dan bujur untuk menempatkan penanda dasar atau memusatkan peta.
• Geocoding terbalik (GeocodeLocation): Mengonversi koordinat geografis menjadi alamat yang dapat dibaca manusia.
• Geocoding tempat (GeocodePlace): Menemukan alamat dan koordinat berformat untuk ID Tempat yang diketahui.

Contoh permintaan dan respons

Anda dapat mengakses Geocoding API melalui antarmuka HTTP. Berikut adalah contoh panduan memulai untuk Menelusuri tujuan, geocoding maju, dan geocoding terbalik.

Permintaan dan respons penelusuran tujuan (data kedatangan hiperlokal)

Contoh berikut mengirimkan permintaan HTTP POST ke SearchDestinations untuk "1600 Amphitheatre Parkway, Mountain View, CA". Perhatikan bahwa SearchDestinations memerlukan header X-Goog-FieldMask yang menentukan kolom yang akan ditampilkan:

curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "1600 Amphitheatre Parkway, Mountain View, CA"
  }
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-FieldMask: destinations.primary.displayName,destinations.primary.formattedAddress,destinations.primary.location,destinations.primary.displayPolygon,destinations.entrances,destinations.navigationPoints,destinations.landmarks' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
"https://geocode.googleapis.com/v4/geocode/destinations"

Berikut adalah contoh respons SearchDestinations yang menampilkan poligon jejak bangunan, pintu masuk yang direkomendasikan, titik navigasi yang dapat dirutekan, dan tempat terkenal di sekitar:

{
  "destinations": [
    {
      "primary": {
        "displayName": { "text": "Googleplex", "languageCode": "en" },
        "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
        "location": { "latitude": 37.4220656, "longitude": -122.0840897 },
        "displayPolygon": {
          "type": "Polygon",
          "coordinates": [
            [
              [-122.084958, 37.422145],
              [-122.084112, 37.422610],
              [-122.083510, 37.421980],
              [-122.084958, 37.422145]
            ]
          ]
        }
      },
      "entrances": [
        {
          "location": { "latitude": 37.422189, "longitude": -122.084215 },
          "tags": ["PREFERRED"]
        }
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "Eg...",
          "displayName": { "text": "Amphitheatre Pkwy Dropoff", "languageCode": "en" },
          "location": { "latitude": 37.421912, "longitude": -122.084301 },
          "travelModes": ["DRIVE"],
          "usages": ["DROPOFF", "PICKUP"]
        }
      ],
      "landmarks": [
        {
          "place": { "displayName": { "text": "Charleston Park", "languageCode": "en" } },
          "relationalDescription": { "text": "Adjacent to Charleston Park", "languageCode": "en" },
          "straightLineDistanceMeters": 85.4
        }
      ]
    }
  ]
}

Permintaan geocoding dan respons (pencarian lintang/bujur)

Contoh berikut meminta lintang dan bujur "1600 Amphitheatre Parkway, Mountain View, CA", dan menentukan bahwa output harus dalam format JSON.

curl -H "X-Goog-Api-Key: YOUR_API_KEY" \
"https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"

Anda dapat mengujinya dengan memasukkan URL ke browser web (pastikan untuk mengganti YOUR_API_KEY dengan kunci API Anda yang sebenarnya). Respons berisi garis lintang dan bujur dari alamat.

Lihat panduan developer untuk mengetahui informasi selengkapnya tentang membuat URL permintaan geocoding, parameter yang tersedia, dan memahami respons.

Di bawah ini adalah contoh respons geocoding, dalam JSON:

{
  "results": [
    {
      "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ",
      "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ",
      "location": {
        "latitude": 37.4438238,
        "longitude": -122.0869895
      },
      "granularity": "ROOFTOP",
      "viewport": {
        "low": {
          "latitude": 37.4424748197085,
          "longitude": -122.0883384802915
        },
        "high": {
          "latitude": 37.445172780291493,
          "longitude": -122.08564051970852
        }
      },
      "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      "postalAddress": {
        "regionCode": "US",
        "languageCode": "en",
        "postalCode": "94043-1351",
        "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"
          ]
        },
        {
          "longText": "1351",
          "shortText": "1351",
          "types": [
            "postal_code_suffix"
          ]
        }
      ],
      "types": [
        "premise",
        "street_address"
      ]
    }
  ]
}

Permintaan geocoding terbalik dan respons (pencarian alamat)

Contoh berikut meminta alamat yang sesuai dengan lintang/bujur tertentu di Brooklyn, NY, AS. Itu menetapkan bahwa keluaran harus dalam format JSON.

https://geocode.googleapis.com/v4/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEY

Anda dapat mengujinya dengan memasukkan URL ke browser web (pastikan untuk mengganti 'YOUR_API_KEY' dengan kunci API Anda yang sebenarnya). Responsnya menyertakan alamat yang dapat dibaca manusia untuk lokasi lintang dan bujur.

Lihat panduan developer untuk mengetahui informasi selengkapnya tentang membuat URL permintaan geocoding terbalik, parameter yang tersedia, dan memahami respons.

Di bawah ini adalah contoh respons geocoding terbalik, dalam JSON:

{
  "results": [
    {
      "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE",
      "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE",
      "location": {
        "latitude": 37.4225657,
        "longitude": -122.08465439999999
      },
      "granularity": "ROOFTOP",
      "viewport": {
        "low": {
          "latitude": 37.421214719708509,
          "longitude": -122.08603273029148
        },
        "high": {
          "latitude": 37.423912680291508,
          "longitude": -122.0833347697085
        }
      },
      "bounds": {
        "low": {
          "latitude": 37.4225178,
          "longitude": -122.08484599999998
        },
        "high": {
          "latitude": 37.422609600000008,
          "longitude": -122.0845215
        }
      },
      "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      "postalAddress": {
        "regionCode": "US",
        "languageCode": "en",
        "postalCode": "94043",
        "administrativeArea": "CA",
        "locality": "Mountain View",
        "addressLines": [
          "Google Building 40",
          "1600 Amphitheatre Pkwy"
        ]
      },
      "addressComponents": [
        {
          "longText": "Google Building 40",
          "shortText": "Google Building 40",
          "types": [
            "premise"
          ],
          "languageCode": "en"
        },
        {
          "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": [
        "street_address",
        "subpremise"
      ]
    },
    ... Additional results truncated in this example[] ...
}

Autentikasi, kuota, harga, dan kebijakan

Autentikasi

Untuk menggunakan Geocoding API, Anda harus mengaktifkan API terlebih dahulu dan mendapatkan kredensial autentikasi yang tepat. Untuk informasi selengkapnya, lihat Memulai Google Maps Platform.

Kuota dan harga

Tinjau halaman penggunaan dan penagihan untuk mengetahui detail tentang kuota dan harga yang ditetapkan untuk Geocoding API.

Catatan: Selama Pratinjau, metode Geocoding API v4 dibatasi hingga 25 kueri per detik (QPS). Untuk mengetahui informasi tentang cara meminta kuota yang lebih tinggi, lihat Melihat dan mengelola kuota, lalu pilih Geocoding API sebagai layanan.

Peringatan: Karena risiko keamanan, Anda tidak boleh memanggil metode Geocoding API v4 langsung dari JavaScript sisi klien. Jika Anda melakukannya, meskipun tidak direkomendasikan, perlu diketahui bahwa meminta kuota yang lebih tinggi akan meningkatkan potensi dampak penyalahgunaan kunci API. Lihat Pertimbangan keamanan.

Kebijakan

Penggunaan Geocoding API harus sesuai dengan kebijakan API.