Deskripsi alamat mencakup informasi tambahan yang membantu menggambarkan lokasi menggunakan {i>landmark<i} dan area. Lihat demo deskripsi alamat untuk menjelajahi fitur.
Parameter tambahan
Deskripsi alamat dapat diaktifkan melalui penggunaan extra_computations
. Menyertakan extra_computations=ADDRESS_DESCRIPTORS
dalam permintaan geocoding
, permintaan geocoding terbalik
, atau permintaan geocoding tempat
untuk menerima penjelas alamat
dalam tanggapan 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 dalam urutan
relevansi dengan memperhitungkan kedekatan dengan koordinat yang diminta,
prevalensi bangunan terkenal dan visibilitasnya. Setiap hasil {i>landmark<i} berisi
nilai berikut:
place_id
adalah ID tempat dari hasil tempat terkenal. Lihat ID tempat ringkasan.display_name
adalah nama tampilan tempat terkenal serta berisilanguage_code
dantext
.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 sendiri ke tempat yang
mewakili wilayah kecil, seperti kawasan, sublokalitas, dan
dan kompleks. Area yang berisi koordinat yang diminta akan dicantumkan terlebih dahulu dan
diurutkan dari yang terkecil hingga terbesar. Setiap hasil areas
berisi hal berikut
nilai-nilai:
place_id
adalah ID tempat hasil area. Lihat ID tempat ringkasan.display_name
adalah nama tampilan area serta berisilanguage_code
dantext
.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 pilih negara.
Masukan
Ini adalah fitur Pratinjau dan kami mengharapkan masukan Anda. Harap kirim email kami di address-descriptors-feedback@google.com.