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/v1alpha: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ülecek konum sorgularının listesi. En fazla 20 sorgu belirtebilirsiniz.
locationBias

object (LocationBias)

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

Hem locationBias hem de regionCode belirtilirse locationBias, regionCode'ye göre öncelikli olur.
regionCode

string

İsteğe bağlı. Çö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 eklemek, arama alanını daraltarak genellikle daha iyi sonuçlar sağlar.

Hem locationBias hem de regionCode belirtilirse locationBias, regionCode'ye göre öncelikli olur.

Yanıt metni

v1alpha.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)
    },
    ...
  }
}
Alanlar
results[]

object (Result)

Yalnızca çıkış. Konum sorgularından elde edilen çözümlenmiş varlıkların listesi. İstek queries dizinleriyle 1:1 eşleneceğ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 olursa 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 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" }.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

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 konum öğesine (ö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 "Eiffel Kulesi, 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ümleme sonuçlarının yönlendirileceği bölge.

JSON gösterimi 
{

  // Union field type can be only one of the following:
  "viewport": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Alanlar
type birleşik alanı. Konum önyargısının türü. type aşağıdakilerden yalnızca biri olabilir:
viewport

object (Viewport)

Sınırlayıcı kutuyla tanımlanan bir görüntü alanı.

Görüntü alanı

Enlem-boylam görüntü alanı, çapraz olarak zıt iki low ve high noktasıyla gösterilir. Görüntü alanı, kapalı bir bölge olarak kabul edilir. Yani sınırları da görüntü alanına dahildir. Enlem sınırları -90 ile 90 derece arasında (bu değerler dahil), boylam sınırları ise -180 ile 180 derece arasında (bu değerler dahil) olmalıdır. Çeşitli durumlar şunlardır:

  • low = high ise görüntü alanı tek bir noktadan oluşur.

  • low.longitude > high.longitude ise boylam aralığı ters çevrilir (görüntü alanı 180 derece boylam çizgisini geçer).

  • low.longitude = -180 derece ve high.longitude = 180 derece ise görüntü alanı tüm boylamları içerir.

  • low.longitude = 180 derece ve high.longitude = -180 derece ise boylam aralığı boş olur.

  • low.latitude > high.latitude ise enlem aralığı boş olur.

Hem low hem de high doldurulmalıdır ve gösterilen kutu boş olamaz (yukarıdaki tanımlarda belirtildiği gibi). Boş bir görünüm penceresi hataya neden olur.

Örneğin, bu görünüm penceresi New York City'yi tamamen kapsar:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON gösterimi 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Alanlar
low

object (LatLng)

Zorunlu. Görüntü alanının en düşük noktası.
high

object (LatLng)

Zorunlu. Görüntü alanının en yüksek noktası.

LatLng

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem derecelerini ve boylam derecelerini temsil eden bir çift çift sayı olarak ifade edilir. Aksi belirtilmediği sürece bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

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 düzeyi, çözünürlüğün doğru olduğunu ve belirli bir coğrafi varlığı (ör. belirli bir yer) temsil ettiğini gösterir.