Mengatasi permintaan dan respons deskriptor

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.

Deskriptor alamat mencakup informasi tambahan yang membantu mendeskripsikan lokasi menggunakan landmark dan area. Lihat demo deskriptor alamat untuk menjelajahi fitur ini.

Catatan: Deskriptor alamat lebih berguna di lokasi yang lebih padat. Jika tidak ada landmark atau area yang relevan, respons mungkin kosong. Beberapa wilayah tidak memiliki data area yang mendetail dan hanya akan menampilkan landmark.

Parameter tambahan

Deskriptor alamat dapat diaktifkan melalui penggunaan parameter extra_computations. Sertakan extra_computations=ADDRESS_DESCRIPTORS dalam permintaan geocoding , permintaan geocoding terbalik , atau permintaan geocoding tempat untuk menerima deskriptor alamat dalam respons Anda.

Contoh dalam geocoding

Kueri berikut berisi alamat tempat di Delhi:

https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

Contoh dalam geocoding tempat

Kueri berikut berisi ID tempat di Delhi:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

Catatan: Tidak semua tempat kompatibel dengan deskriptor alamat. Tempat yang sangat besar (misalnya, bandara) atau area (misalnya, wilayah pos) tidak akan pernah menerima deskriptor alamat.

Contoh dalam geocoding terbalik

Kueri berikut berisi nilai garis lintang/bujur untuk lokasi di Delhi:

https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

Catatan: Geocoding terbalik menyertakan satu deskriptor alamat di tingkat respons. Geocoding dan geocoding tempat akan menerima deskriptor alamat untuk setiap hasil yang kompatibel dalam respons

Respons

Contoh address_descriptor adalah sebagai berikut:

{
  "address_descriptor" : {
     "areas" : [
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Turkman Gate"
           },
           "place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
        },
        {
           "containment" : "OUTSKIRTS",
           "display_name" : {
              "language_code" : "en",
              "text" : "Chandni Chowk"
           },
           "place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
        },
        {
           "containment" : "NEAR",
           "display_name" : {
              "language_code" : "en",
              "text" : "Katar Ganj"
           },
           "place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
        }
     ],
     "landmarks" : [
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delite Cinema"
           },
           "straight_line_distance_meters" : 29.9306755065918,
           "place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
           "travel_distance_meters" : 418.7794799804688,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "establishment", "movie_theater", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "YES Bank"
           },
           "straight_line_distance_meters" : 66.83731079101562,
           "place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
           "travel_distance_meters" : 489.0340270996094,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "UCO Bank"
           },
           "straight_line_distance_meters" : 25.38849639892578,
           "place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
           "travel_distance_meters" : 403.2246398925781,
           "spatial_relationship" : "ACROSS_THE_ROAD",
           "types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Delhi By Cycle Meeting Point"
           },
           "straight_line_distance_meters" : 44.02867126464844,
           "place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
           "travel_distance_meters" : 97.41281890869141,
           "spatial_relationship" : "AROUND_THE_CORNER",
           "types" : [
              "establishment",
              "point_of_interest",
              "tourist_attraction",
              "travel_agency"
           ]
        },
        {
           "display_name" : {
              "language_code" : "en",
              "text" : "Axis Bank Branch"
           },
           "straight_line_distance_meters" : 102.3495178222656,
           "place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
           "travel_distance_meters" : 330.8566284179688,
           "spatial_relationship" : "DOWN_THE_ROAD",
           "types" : [ "bank", "establishment", "finance", "point_of_interest" ]
        }
     ]
  }
}

Ada dua array di setiap objek address_descriptor: landmarks dan areas. Array landmarks berisi hingga 5 hasil yang diberi peringkat berdasarkan relevansi dengan mempertimbangkan kedekatan dengan koordinat yang diminta, prevalensi landmark, dan visibilitasnya. Setiap hasil landmark berisi nilai berikut:

• place_id adalah ID tempat hasil landmark. Lihat ringkasan ID tempat overview.
• display_name adalah nama tampilan landmark dan berisi language_code dan text.
• straight_line_distance_meters adalah jarak titik ke titik dalam meter antara koordinat input dan hasil landmark.
• travel_distance_meters adalah jarak dalam meter yang ditempuh melalui jaringan jalan (mengabaikan batasan jalan) antara koordinat input dan hasil landmark.
• spatial_relationship adalah perkiraan hubungan antara koordinat input dan hasil landmark:
• "NEAR" adalah hubungan default jika tidak ada hal berikut yang berlaku.
• "WITHIN" jika koordinat input berada dalam batas struktur yang terkait dengan landmark.
• "BESIDE" jika koordinat input berdekatan langsung dengan landmark atau titik akses landmark.
• "ACROSS_THE_ROAD" jika koordinat input berada tepat di seberang landmark di sisi lain rute.
• "DOWN_THE_ROAD" jika koordinat input berada di sepanjang rute yang sama dengan landmark, tetapi bukan "BESIDES" atau "ACROSS_THE_ROAD".
• "AROUND_THE_CORNER" jika koordinat input berada di sepanjang rute yang tegak lurus dengan landmark (dibatasi hingga satu belokan).
• "BEHIND" jika koordinat input secara spasial dekat dengan landmark, tetapi jauh dari titik aksesnya.
• types adalah Jenis tempat landmark.

Objek areas berisi hingga 3 respons dan membatasi diri pada tempat yang mewakili wilayah kecil, seperti lingkungan, sublokalitas, dan kompleks besar. Area yang berisi koordinat yang diminta akan dicantumkan terlebih dahulu dan diurutkan dari yang terkecil hingga terbesar. Setiap hasil areas berisi nilai berikut:

• place_id adalah ID tempat hasil area. Lihat ringkasan ID tempat overview.
• display_name adalah nama tampilan area dan berisi language_code dan text.
• containment adalah perkiraan hubungan penampungan antara koordinat input dan hasil area:
• "NEAR" adalah hubungan default jika tidak ada hal berikut yang berlaku.
• "WITHIN" jika koordinat input dekat dengan pusat area.
• "OUTSKIRTS" jika koordinat input dekat dengan tepi area.

Cakupan

Deskriptor alamat tersedia di semua wilayah. Lihat cakupan wilayah untuk mengetahui detailnya.

Masukan

Fitur ini tersedia di semua wilayah dan berada dalam GA untuk India dan dalam tahap peluncuran Eksperimental pra-GA untuk semua wilayah lainnya. Kami akan menghargai masukan. Kirim email kepada kami di [e-mail].