Mengatasi permintaan dan respons deskriptor

Deskripsi alamat menyertakan informasi tambahan yang membantu mendeskripsikan lokasi menggunakan penanda dan area. Lihat demo deskripsi alamat untuk mempelajari fitur ini.

Parameter tambahan

Deskripsi 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 deskripsi 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 untuk lokasi di Delhi:

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

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

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 maksimal 5 hasil yang diberi peringkat berdasarkan urutan relevansi dengan mempertimbangkan kedekatan dengan koordinat yang diminta, prevalensi penanda dan visibilitasnya. Setiap hasil penanda berisi nilai berikut:

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

Objek areas berisi maksimal 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 dari hasil area. Lihat ringkasan ID tempat.
  • display_name adalah nama tampilan area dan berisi language_code dan text.
  • containment adalah estimasi hubungan pembatasan antara koordinat input dan hasil area:
    • "NEAR" adalah hubungan default jika tidak ada satu pun dari hal berikut yang berlaku.
    • "WITHIN" jika koordinat input berada di dekat pusat area.
    • "OUTSKIRTS" jika koordinat input berada di dekat tepi area.

Cakupan

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

Masukan

Ini adalah fitur Pratinjau dan kami akan menghargai masukan Anda. Kirim email ke address-descriptors-feedback@google.com.