Açıklayıcıların isteği ve yanıtı

Adres tanımlayıcıları, bir konumu açıklamaya yardımcı olan ek bilgiler içerir önemli noktaları ve alanları kullanarak. Adres tanımlayıcılar demosuna göz atın ziyaret edebilirsiniz.

Ek parametreler

Adres tanımlayıcıları, extra_computations kullanılarak etkinleştirilebilir parametresinden sonra bir değer girin. extra_computations=ADDRESS_DESCRIPTORS öğesini bir coğrafi kodlama isteğine dahil edin , coğrafi kodlama isteğini tersine çevirme veya yer coğrafi kodlama isteği ve yanıtınızda adres tanımlayıcıları alabilirsiniz.

Coğrafi kodlama örneği

Aşağıdaki sorgu, Delhi'deki bir yerin adresini içerir:

https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY

Yer coğrafi kodlamasına örnek

Aşağıdaki sorgu, Delhi'deki bir yerin yer kimliğini içerir:

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

.

Ters coğrafi kodlama örneği

Aşağıdaki sorgu, Türkiye'deki bir konumun enlem/boylam değerini Delhi:

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

.

Yanıt

address_descriptor için aşağıdaki gibi bir örnek verilebilir:

{
  "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" ]
        }
     ]
  }
}

Her address_descriptor nesnesinde iki dizi bulunur: landmarks ve areas. landmarks dizisi, aşağıdaki sıralamaya göre sıralanmış en fazla 5 sonuç içerir: istenen koordinata yakınlık dikkate alınarak, ve görünürlüğü. Her önemli nokta sonucu şu değerlere sahiptir:

• place_id, önemli noktalar sonucunun yer kimliğidir. Yer kimliğini görün genel bakış bölümüne bakın.
• display_name, önemli noktanın görünen adı olup language_code ile text kelimelerini içerir.
• straight_line_distance_meters, giriş koordinatı ile önemli nokta sonucu arasındaki metre cinsinden nokta-nokta mesafesidir.
• travel_distance_meters, yol ağında (yol kısıtlamaları yok sayılarak) giriş koordinatı ile önemli nokta sonucu arasındaki katedilen mesafedir.
• spatial_relationship, giriş koordinatı ile önemli nokta sonucu arasındaki tahmini ilişkidir:
• Aşağıdakilerin hiçbiri geçerli olmadığında varsayılan ilişki "NEAR" olur.
• Giriş koordinatı, önemli noktayla ilişkili yapının sınırları içinde olduğunda "WITHIN".
• Giriş koordinatı, önemli noktanın veya önemli noktanın erişim noktasının hemen bitişiğinde olduğunda "BESIDE".
• Giriş koordinatı rotanın diğer tarafındaki önemli noktanın doğrudan tersi olduğunda "ACROSS_THE_ROAD".
• Giriş koordinatı, önemli noktayla aynı rota üzerinde olduğunda ancak "BESIDES" veya "ACROSS_THE_ROAD" olmadığında "DOWN_THE_ROAD".
• Giriş koordinatı, önemli nokta olarak dikey bir rota üzerinde olduğunda (tek bir dönüşle sınırlıdır) "AROUND_THE_CORNER".
• Giriş koordinatı, yer işaretine yakın, ancak erişim noktasından uzak olduğunda "BEHIND".
• types, önemli noktanın Yer türleridir.

areas nesnesi en fazla 3 yanıt içerir ve kendisini mahalleler, semtler ve büyükşehir bölgeleri gibi küçük bölgeleri kompleksler. İstenen koordinatı içeren bölgeler listenin başında ve en küçükten en büyüğe doğru sıralanır. Her areas sonucu şunu içerir: değerleri:

• place_id, alan sonucunun yer kimliğidir. Yer kimliğini görün genel bakış bölümüne bakın.
• display_name, alanın görünen adı olup language_code ile text kelimelerini içerir.
• containment, giriş koordinatı ile alan sonucu arasındaki tahmini kapsama ilişkisidir:
• Aşağıdakilerin hiçbiri geçerli olmadığında varsayılan ilişki "NEAR" olur.
• Giriş koordinatı alanın merkezine yakın olduğunda "WITHIN".
• Giriş koordinatı alanın kenarına yakın olduğunda "OUTSKIRTS".

Kapsam

Bu özellik yalnızca belirli ülke.

Geri bildirim

Bu bir Önizleme özelliğidir ve geri bildirimlerinizi almaktan memnuniyet duyarız. Lütfen e-posta gönderin address-descriptors-feedback@google.com adresinden bize ulaşın.