Method: resolveNames

Bir yer adları (veya adresler) listesini Google Haritalar'daki belirli coğrafi varlıklara (ör. yerler) dönüştürür.

HTTP isteği

POST https://mapstools.googleapis.com/v1:resolveNames

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
Alanlar
queries[]

object (LocationQuery)

Zorunlu. Çözümlenecek konum sorgularının listesi. En fazla 20 sorgu belirtebilirsiniz.
locationBias

object (LocationBias)

İsteğe bağlıdır. Çözünürlük sonuçlarını etkilemek için isteğe bağlı bir bölge. Belirtilmişse çözüm sonuçları, bu bölgeye daha yakın olan öğelerden yana olacaktır. locationBias veya regionCode gibi karakterler eklemek, arama alanını daraltarak genellikle daha iyi sonuçlar sağlar.

Hem locationBias hem de regionCode belirtilmişse locationBias, regionCode'ye göre öncelikli olur.
regionCode

string

İsteğe bağlıdır. Çözümleme sonuçlarını etkilemek için isteğe bağlı bir bölge kodu. Belirtilmişse çözüm sonuçları, belirtilen bölgede veya bölgenin yakınında bulunan öğelerden yana olacaktır. Bu, bir CLDR bölge kodu olmalıdır. Örneğin, "US" veya "CA". locationBias veya regionCode gibi karakterler eklemek, arama alanını daraltarak genellikle daha iyi sonuçlar sağlar.

Hem locationBias hem de regionCode belirtilmişse locationBias, regionCode'ye göre öncelikli olur.

Yanıt metni

v1.resolveNames için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  },
  "saveToMapsUrl": string
}
Alanlar
results[]

object (Result)

Yalnızca çıkış. Konum sorgularından elde edilen çözümlenmiş varlıkların listesi. İsteğin queries dizinleriyle 1:1 eşleşeceği garanti edilir. i dizinindeki boş dize, bu sorgu için çözümlemenin başarısız olduğunu gösterir. Çözüm başarısız olduysa lütfen hata durumu için failedRequests alanını kontrol edin.
failedRequests

map (key: integer, value: object (Status))

Yalnızca çıkış. Kısmi hataları gösteren bir harita. Anahtar, queries alanındaki başarısız isteğin dizinidir. Değer, çözümün neden başarısız olduğunu ayrıntılı olarak açıklayan hata durumudur.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
saveToMapsUrl

string

Yalnızca çıkış. Başarıyla çözülen tüm öğeleri Google Haritalar'a kaydetme bağlantısı.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/maps-platform.mapstools

LocationQuery

Konum sorgusu, Google Haritalar ile çözümlenebilen belirli bir konum öğesini ifade eder. Şu anda konum sorgusu olarak yalnızca yer adları ve adresler desteklenmektedir.

JSON gösterimi 
{
  "text": string
}
Alanlar
text

string

Zorunlu. Google Haritalar'da belirli bir coğrafi varlığa (ör. yer veya adres) çözümlenecek metin sorgusu. Sorgu ne kadar ayrıntılı olursa çözüm o kadar doğru olur. Örneğin, "San Francisco", "Googleplex, Mountain View, CA", "1600 Amphitheatre Parkway, Mountain View, CA" veya "Eiffel Tower, Paris". Sorgular belirli bir adres veya yer adı olmalıdır. Zincir adı (ör. Starbucks) gibi genel konumlar veya "restoranlar" gibi arama sorguları desteklenmez.

LocationBias

Çözüm sonuçlarının yönlendirileceği bölge.

JSON gösterimi 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "viewport": {
    object (Viewport)
  }
  // End of mutually exclusive fields.
}
Alanlar
Konum yanlılığının türü. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
viewport

object (Viewport)

Sınırlayıcı kutuyla tanımlanan bir görüntü alanı.
Birbirini dışlayan alanların sonu.

Sonuç

Belirli bir konum sorgusundan elde edilen tek bir çözümlenmiş varlık ve çözümlenmenin güven düzeyi.

JSON gösterimi 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
Alanlar
entity

object (Entity)

Yalnızca çıkış. Konum sorgusundan elde edilen çözümlenmiş öğe.
confidence

enum (Confidence)

Yalnızca çıkış. Çözümün güven düzeyi.

Güven

Çözümün güven düzeyi.

Sıralamalar
CONFIDENCE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
MEDIUM Orta güven düzeyi, çözümün büyük olasılıkla doğru olduğunu ancak başka adayların da olabileceğini gösterir.
HIGH Yüksek güven, çözünürlüğün doğru olduğunu ve belirli bir coğrafi varlığı (ör. belirli bir yer) temsil ettiğini gösterir.