Ters coğrafi kodlama adres açıklayıcıları isteği ve yanıtı

Adres tanımlayıcılar, standart ters coğrafi kodlama yanıtına ek bilgiler döndürür. Bu yanıt, önemli noktaları ve alanları kullanarak enlem ve boylam koordinatlarının açıklanmasına yardımcı olur. API'yi keşfetmek için adres tanımlayıcıları demosuna göz atın.

Ters coğrafi kodlama istekleri - Ek parametreler

İsteğe bağlı parametreler

Ters coğrafi kodlama isteğine ekleyebileceğiniz isteğe bağlı parametreler şunlardır:

Ters coğrafi kodlama örneği

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

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

Yanıt

Yukarıdaki sorgu, aşağıdaki gibi ek bir address_descriptor döndürür:

{
  "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" ]
        }
     ]
  },
 ... Results (reverse geocoding response) ...

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ış konusuna göz atın.
  • display_name, önemli noktanın görünen adı olup language_code ile text değerlerini içerir.
  • straight_line_distance_meters, giriş koordinatı ile önemli nokta sonucu arasındaki nokta mesafesinin metre cinsinden değeridir.
  • travel_distance_meters, giriş koordinatı ile önemli noktalar sonucu arasındaki yol ağı üzerinde katedilen mesafenin metre cinsinden değeridir (yol kısıtlamaları dikkate alınmaz).
  • spatial_relationship, giriş koordinatı ve önemli nokta sonucu arasındaki tahmini ilişkidir:
    • "NEAR", aşağıdakilerden hiçbiri geçerli olmadığında varsayılan ilişkidir.
    • "WITHIN".
    • Giriş koordinatı, yer işareti veya önemli noktanın erişim noktasının doğrudan bitişiğinde olduğunda "BESIDE".
    • Giriş koordinatı, rotanın diğer tarafındaki önemli noktanın doğrudan karşısında olduğunda "ACROSS_THE_ROAD".
    • Giriş koordinatı, önemli noktayla aynı rota üzerinde olduğunda ancak "BESIDES" veya "ACROSS_THE_ROAD" ile aynı rota üzerinde olmadığında "DOWN_THE_ROAD".
    • "AROUND_THE_CORNER". Giriş koordinatı, önemli nokta olarak dik bir rotada (tek bir dönüşle sınırlandırılmıştır) kullanıldığında.
    • Giriş koordinatı, önemli noktaya mesafeli olarak yakın ancak erişim noktasından uzakta olduğunda "BEHIND".
  • types, yer işaretinin Yer türleridir.

areas nesnesi en fazla 3 yanıt içerir ve kendisini mahalleler, alt konumlar ve büyük kompleksler gibi küçük bölgeleri temsil eden yerlerle sınırlandırır. İstenen koordinatı içeren alanlar listenin başında 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, alan sonucunun yer kimliğidir. Yer kimliğine genel bakış konusuna göz atın.
  • display_name, alanın görünen adı olup language_code ile text değerlerini içerir.
  • containment, giriş koordinatı ile alanlar sonucu arasındaki tahmini kapsama ilişkisidir:
    • "NEAR", aşağıdakilerden hiçbiri geçerli olmadığında varsayılan ilişkidir.
    • 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 ülkelerde kullanılabilir.

Geri bildirim

Bu deneysel bir özelliktir. Geri bildirimlerinizi almaktan memnuniyet duyarız. Lütfen address-descriptors-feedback@google.com adresinden bize e-posta gönderin.