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

Adres tanımlayıcıları, önemli yerleri ve bölgeleri kullanarak bir konumu tanımlamaya yardımcı olan ek bilgiler içerir. Özelliği keşfetmek için adres tanımlayıcıları demosuna göz atın.

Ek parametreler

Adres tanımlayıcıları, extra_computations parametresi kullanılarak etkinleştirilebilir. Coğrafi kodlama isteğine extra_computations=ADDRESS_DESCRIPTORS ekleme , 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

Tersine coğrafi kodlama örneği

Aşağıdaki sorgu, Delhi'deki bir konumun enlem/boylam değerini içerir:

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 vardır: 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 bir önemli yer sonucu aşağıdaki değerleri içerir:

  • place_id, önemli yerler 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 yerler sonucu arasındaki noktadan noktaya mesafedir (metre cinsinden).
  • 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 yer işaretleri 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 yer işaretinin tam karşısında olduğunda "ACROSS_THE_ROAD".
    • Giriş koordinatı yer işaretiyle aynı rota üzerindeyse ancak "BESIDES" veya "ACROSS_THE_ROAD" değilse "DOWN_THE_ROAD".
    • Giriş koordinatı, yer işareti olarak dik bir rota üzerindeyse (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, yer işaretinin yer türleridir.

areas nesnesi en fazla 3 yanıt içerir ve kendisini mahalleler, semtler ve büyük mahalleler 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 şunları içerir değerleri:

  • place_id, alan sonucunun yer kimliğidir. Yer kimliğine genel bakış başlıklı makaleyi inceleyin.
  • display_name, alanın görünen adıdır ve language_code ile text içerir.
  • containment, giriş koordinatı ile alanlar sonucu arasındaki tahmini kapsayıcı ilişkidir:
    • Aşağıdakilerden 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

Adres tanımlayıcıları tüm bölgelerde kullanılabilir. Görüntüleyin bölge konusunu inceleyin.

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.