Method: resolveNames

Yer adlarının (veya adreslerin) listesini Google Haritalar'daki belirli coğrafi öğelere (ö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ı etkileyecek isteğe bağlı bir bölge. Belirtilirse çözümleme sonuçları bu bölgeye daha yakın olan varlıklara göre önceliklendirilir. locationBias veya regionCode ifadesini eklemek, arama alanını daraltarak genellikle daha iyi sonuçlar verir.

Hem locationBias hem de regionCode belirtilirse locationBias, regionCode'e 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. Belirtilirse çözümleme sonuçları, belirtilen bölgede veya bölgenin yakınında bulunan öğelere göre belirlenir. Bu, CLDR bölge kodu olmalıdır. Örneğin, "US" veya "CA". locationBias veya regionCode ifadesini eklemek, arama alanını daraltarak genellikle daha iyi sonuçlar verir.

Hem locationBias hem de regionCode belirtilirse locationBias, regionCode'e 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 çözümlenen varlıkların listesi. İstek queries dizinleriyle 1:1 eşleme garantisi. i dizinindeki boş dize, söz konusu 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ı bildiren bir eşleme. Anahtar, queries alanındaki başarısız isteğin dizinidir. Değer, çözümün neden başarısız olduğunu 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ümlenen 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 temsil 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 öğeye (ör. yer veya adres) çözümlenecek metin sorgusu. Sorgu ne kadar ayrıntılı olursa çözüm de o kadar doğru olur. Örneğin, "San Francisco", "Googleplex, Mountain View, CA", "1600 Amphitheatre Parkway, Mountain View, CA" veya "Eyfel Kulesi, Paris". Sorgular belirli bir adres veya yer adı olmalıdır. Zincir adı (ör. Starbucks) gibi yaklaşık konumlar veya "restoranlar" gibi arama sorguları desteklenmez.

LocationBias

Çözümleme 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 tercihi türü. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
viewport

object (Viewport)

Sınırlayıcı kutu tarafından tanımlanan görüntü alanı.
Birbirini hariç tutan alanların sonu.

Sonuç

Belirli bir konum sorgusundan çözümlenen tek bir varlık ve çözümlemenin güven düzeyi.

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

object (Entity)

Yalnızca çıkış. Konum sorgusundan çözümlenen varlık.
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 düzeyde güven, çözümün muhtemelen doğru olduğunu ancak başka adaylar da olabileceğini gösterir.
HIGH Yüksek güven, çözümün doğru olduğunu ve belirli bir coğrafi öğeyi (ör. belirli bir yer) temsil ettiğini gösterir.