Deskripsi alamat mencakup 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 suatu 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 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 berdasarkan relevansi dengan mempertimbangkan kedekatan dengan koordinat yang diminta, prevalensi tempat terkenal, dan visibilitasnya. Setiap hasil tempat terkenal berisi nilai berikut:
place_idadalah ID tempat dari hasil tempat terkenal. Lihat ringkasan ID tempat.display_nameadalah nama tampilan tempat terkenal dan berisilanguage_codesertatext.straight_line_distance_metersadalah jarak titik ke titik dalam meter antara koordinat input dan hasil tempat terkenal.travel_distance_metersadalah jarak dalam meter yang ditempuh melalui jaringan jalan (mengabaikan pembatasan jalan) antara koordinat input dan hasil tempat terkenal.spatial_relationshipadalah perkiraan hubungan antara koordinat input dan hasil tempat terkenal:"NEAR"adalah hubungan default jika tidak ada hal berikut yang berlaku."WITHIN"jika koordinat input berada dalam batas struktur yang terkait dengan tempat terkenal."BESIDE"jika koordinat input berada tepat di samping tempat terkenal atau titik akses tempat terkenal."ACROSS_THE_ROAD"jika koordinat input berada tepat di seberang tempat terkenal di sisi lain rute."DOWN_THE_ROAD"jika koordinat input berada di sepanjang rute yang sama dengan tempat terkenal, tetapi bukan"BESIDES"atau"ACROSS_THE_ROAD"."AROUND_THE_CORNER"jika koordinat input berada di sepanjang rute tegak lurus sebagai tempat terkenal (dibatasi untuk satu belokan)."BEHIND"jika koordinat input secara spasial dekat dengan tempat terkenal, tetapi jauh dari titik aksesnya.typesadalah Jenis tempat bangunan terkenal.
Objek areas berisi hingga 3 respons dan membatasi dirinya pada 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 hingga terbesar. Setiap hasil areas berisi nilai berikut:
place_idadalah ID tempat dari hasil area. Lihat ringkasan ID tempat.display_nameadalah nama tampilan area dan berisilanguage_codesertatext.containmentadalah perkiraan hubungan cakupan 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 dekat dengan tepi area.
Cakupan
Deskripsi alamat tersedia di semua wilayah. Lihat cakupan wilayah untuk mengetahui detailnya.
Masukan
Fitur ini tersedia di semua wilayah dan berstatus GA untuk India serta dalam tahap peluncuran Eksperimental pra-GA untuk semua wilayah lainnya. Kami akan menghargai masukan Anda. Laporkan bug di issue tracker.