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

Adres tanımlayıcılar, önemli noktaları ve alanları kullanarak bir konumun tanımlanmasına 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. Yanıtınızda adres tanımlayıcıları almak için extra_computations=ADDRESS_DESCRIPTORS değerini bir coğrafi kodlama isteğine, tersine coğrafi kodlama isteğine veya yer coğrafi kodlama isteğine ekleyin.

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 örneği aşağıda verilmiştir:

{
  "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, istenen koordinata olan yakınlık, yer işaretinin yaygınlığı ve görünürlüğü dikkate alınarak alaka düzeyine göre sıralanmış en fazla 5 sonuç içerir. Her bir önemli yer sonucu aşağıdaki değerleri içerir:

  • place_id, önemli yerler sonucunun yer kimliğidir. Yer kimliğine genel bakış başlıklı makaleyi inceleyin.
  • display_name, yer işaretinin görünen adıdır ve language_code ile text içerir.
  • straight_line_distance_meters, giriş koordinatı ile önemli nokta sonucu arasındaki metre cinsinden nokta-nokta mesafesidir.
  • travel_distance_meters, giriş koordinatı ile yer işaretleri sonucu arasında yol ağı üzerinden kat edilen mesafedir (yol kısıtlamaları dikkate alınmaz) ve metre cinsindendir.
  • spatial_relationship, giriş koordinatı ile yer işaretleri sonucu arasındaki tahmini ilişkidir:
    • Aşağıdakilerden hiçbiri geçerli olmadığında varsayılan ilişki "NEAR" olur.
    • Giriş koordinatı, belirgin işaretle ilişkili yapının sınırları içindeyse "WITHIN".
    • Giriş koordinatı doğrudan yer işaretinin veya yer işaretinin erişim noktasının yanında 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".
    • "BEHIND" Giriş koordinatı, yer işaretine yakın ancak erişim noktasından uzak olduğunda.
  • types, yer işaretinin yer türleridir.

areas nesnesi en fazla 3 yanıt içerir ve mahalleler, alt yerel bölgeler ve büyük kompleksler gibi küçük bölgeleri temsil eden yerlerle sınırlıdır. İstenen koordinatı içeren alanlar ilk sırada listelenir ve en küçükten en büyüğe doğru sıralanır. Her areas sonucu aşağıdaki değerleri içerir:

  • place_id, alanlar 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. Ayrıntılar için bölge kapsamını inceleyin.

Geri bildirim

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