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

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

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

Coğrafi kodlamada örnek

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

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ındaki örnek

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

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 ile ilgili bir örnek:

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

  • place_id, önemli noktalar sonucunun yer kimliğidir. Yer kimliğine genel bakış bölümünü inceleyin.
  • display_name, önemli noktanın görünen adıdır ve language_code ile text değerlerini içerir.
  • straight_line_distance_meters, giriş koordinatı ile önemli yerler sonucu arasındaki nokta nokta mesafedir (metre cinsinden).
  • travel_distance_meters, giriş koordinatı ile önemli yer sonucu arasında yol ağı üzerinden (yol kısıtlamaları dikkate alınmadan) kat edilen mesafeyi metre cinsinden gösterir.
  • spatial_relationship, giriş koordinatı ile önemli yerler sonucu arasındaki tahmini ilişkidir:
    • Aşağıdakilerden 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".
    • "BESIDE", giriş koordinatı doğrudan önemli noktanın veya önemli noktanın erişim noktasının bitişiğinde olduğunda kullanılır.
    • "ACROSS_THE_ROAD": Giriş koordinatı, rotanın diğer tarafındaki önemli noktanın tam karşısındaysa kullanılır.
    • "DOWN_THE_ROAD" Giriş koordinatı, önemli yerle aynı rota üzerinde olduğunda ancak "BESIDES" veya "ACROSS_THE_ROAD" olmadığında.
    • Giriş koordinatı, önemli nokta ile dikey bir rota üzerindeyse (tek bir dönüşle sınırlı) "AROUND_THE_CORNER".
    • "BEHIND" Giriş koordinatı, önemli yere yakın ancak erişim noktasına uzak olduğunda
  • types, simge yapının yer türleridir.

areas nesnesi en fazla 3 yanıt içerir ve kendisini mahalleler, alt yerleşim birimleri ve büyük kompleksler gibi küçük bölgeleri temsil eden yerlerle sınırlar. İstenen koordinatı içeren alanlar önce listelenir ve küçükten 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 değerlerini içerir.
  • containment, giriş koordinatı ile alan sonucu arasındaki tahmini kapsama ilişkisidir:
    • 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".
    • "OUTSKIRTS", giriş koordinatı alanın kenarına yakın olduğunda.

Kapsam

Adres tanımlayıcılar tüm bölgelerde kullanılabilir. Ayrıntılar için bölge kapsamı başlıklı makaleyi inceleyin.

Geri bildirim

Bu özellik tüm bölgelerde kullanılabilir. Hindistan'da GKST'ye sunulmuştur. Diğer tüm bölgelerde ise GKST öncesi deneysel lansman aşamasındadır. Geri bildirimlerinizi bekliyoruz. Lütfen Issue Tracker'da hata bildiriminde bulunun.