Membalik permintaan dan respons deskriptor alamat geocoding

Deskriptor alamat menampilkan informasi tambahan ke respons geocoding terbalik standar yang membantu menjelaskan koordinat lintang dan bujur dengan menggunakan tempat dan area. Lihat demo deskripsi alamat untuk mempelajari API.

Permintaan geocoding terbalik - Parameter tambahan

Parameter opsional

Ini adalah parameter opsional yang dapat Anda sertakan dalam permintaan geocoding terbalik:

Contoh geocoding terbalik

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

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

Respons

Kueri di atas menampilkan address_descriptor tambahan 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" ]
        }
     ]
  },
 ... Results (reverse geocoding response) ...

Ada dua array di setiap objek address_descriptor: landmarks dan areas. Array landmarks berisi hingga 5 hasil yang diberi peringkat dalam urutan relevansi dengan mempertimbangkan kedekatan terhadap koordinat yang diminta, kelaziman tempat terkenal, dan visibilitasnya. Setiap hasil tempat terkenal berisi nilai berikut:

  • place_id adalah ID tempat hasil tempat terkenal. Lihat ringkasan ID tempat.
  • display_name adalah nama tampilan tempat terkenal dan 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 perkiraan hubungan antara koordinat input dan hasil tempat terkenal:
    • "NEAR" adalah hubungan default jika tidak ada hal berikut yang berlaku.
    • "WITHIN" saat koordinat input berada dalam batas struktur yang terkait dengan tempat terkenal.
    • "BESIDE" jika koordinat input bersebelahan langsung dengan titik akses tempat terkenal atau tempat terkenal.
    • "ACROSS_THE_ROAD" saat koordinat input persis berlawanan dengan tempat terkenal di sisi lain rute.
    • "DOWN_THE_ROAD" saat 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 yang tegak lurus sebagai penanda (dibatasi untuk satu belokan).
    • "BEHIND" saat koordinat input secara spasial dekat dengan tempat terkenal, tetapi jauh dari titik aksesnya.
  • types adalah Jenis tempat tempat terkenal.

Objek areas berisi hingga 3 respons dan membatasi dirinya sendiri ke tempat yang mewakili wilayah kecil, seperti lingkungan, sublokalitas, dan kompleks besar. Area yang berisi koordinat yang diminta dicantumkan terlebih dahulu dan diurutkan dari yang terkecil ke 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 ini dan 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" jika koordinat input dekat dengan pusat area.
    • "OUTSKIRTS" saat koordinat input dekat dengan tepi area.

Cakupan

Fitur ini hanya tersedia di negara tertentu.

Masukan

Ini adalah fitur eksperimental dan kami akan mengharapkan masukan dari Anda. Kirimkan email kepada kami di address-descriptors-feedback@google.com.