Mengatasi permintaan dan respons deskriptor

Deskripsi alamat menyertakan informasi tambahan yang membantu mendeskripsikan lokasi menggunakan tempat terkenal 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 dari suatu tempat 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 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 hingga 5 hasil yang diberi peringkat sesuai urutan relevansi dengan mempertimbangkan kedekatan dengan koordinat yang diminta, prevalensi tempat terkenal, 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 tempat terkenal.
  • travel_distance_meters adalah jarak dalam meter yang ditempuh melalui jaringan jalan (mengabaikan pembatasan jalan) antara koordinat input dan hasil tempat terkenal.
  • spatial_relationship adalah estimasi hubungan antara koordinat input dan hasil tempat terkenal:
    • "NEAR" adalah hubungan default jika tidak ada hal berikut yang berlaku.
    • "WITHIN" saat koordinat input dimuat dalam batas-batas struktur yang terkait dengan tempat terkenal.
    • "BESIDE" saat koordinat input berdekatan langsung dengan titik akses tempat terkenal atau tempat terkenal.
    • "ACROSS_THE_ROAD" saat koordinat input berlawanan dengan tempat terkenal di sisi lain rute.
    • "DOWN_THE_ROAD" jika koordinat input berada di sepanjang rute yang sama dengan tempat terkenal, tetapi tidak "BESIDES" atau "ACROSS_THE_ROAD".
    • "AROUND_THE_CORNER" saat koordinat input berada di sepanjang rute tegak lurus sebagai tempat terkenal (dibatasi untuk satu belokan).
    • "BEHIND" saat koordinat input secara spasial dekat dengan tempat terkenal, tetapi jauh dari titik aksesnya.
  • types adalah Jenis tempat untuk tempat terkenal.

Objek areas berisi hingga 3 respons dan membatasi dirinya ke tempat yang mewakili wilayah kecil, seperti kawasan, 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.
  • display_name adalah nama tampilan area serta berisi language_code dan text.
  • containment adalah estimasi hubungan pembatasan antara koordinat input dan hasil area:
    • "NEAR" adalah hubungan default jika tidak ada hal berikut yang berlaku.
    • "WITHIN" saat koordinat input dekat dengan pusat area.
    • "OUTSKIRTS" saat koordinat input sudah dekat dengan tepi area.

Cakupan

Fitur ini hanya tersedia di negara tertentu.

Masukan

Fitur ini adalah fitur Pratinjau dan kami mengharapkan masukan Anda. Kirimkan email kepada kami di address-descriptors-feedback@google.com.