Method: places.searchNearby

Konumların yakınındaki yerleri arayın.

HTTP isteği

POST https://places.googleapis.com/v1/places:searchNearby

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

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "languageCode": string,
  "regionCode": string,
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ],
  "maxResultCount": integer,
  "locationRestriction": {
    object (LocationRestriction)
  },
  "rankPreference": enum (RankPreference)
}
Alanlar
languageCode

string

Yer ayrıntıları varsa, tercih edilen dilde görüntülenir. Dil kodu belirtilmemişse veya tanınmıyorsa, herhangi bir dilin yer ayrıntıları döndürülebilir ve bu tür ayrıntılar varsa İngilizce tercih edilir.

Desteklenen dillerin güncel listesi: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

İsteğin geldiği konumun Unicode ülke/bölge kodu (CLDR). Bu parametre, varsa bölgeye özel yer adı gibi yer ayrıntılarını görüntülemek için kullanılır. Parametre, geçerli yasalara göre sonuçları etkileyebilir.

Daha fazla bilgi için https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html adresine bakın.

3 haneli bölge kodlarının şu anda desteklenmediğini unutmayın.
includedTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresinden Dahil Edilen Yer türü (ör. "restoran" veya "gas_station").

A Tablosu'ndan en fazla 50 tür belirtilebilir.

Çakışan türler varsa, yani bir tür hem includedTypes hem de excludedTypes içinde görünüyorsa INVALID_ARGUMENT hatası döndürülür.

Bir yer türü, birden çok tür kısıtlamasıyla belirtilirse, yalnızca tüm kısıtlamaları karşılayan yerler döndürülür. Örneğin, {includedTypes = ["Restaurant"], excludedPrimaryTypes = ["lokanta"]} bulunuyorsa döndürülen yerler "restoran" ile ilgili hizmetler sağlar ancak esas olarak "restoran" olarak faaliyet göstermez.
excludedTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresinden Hariç Tutulan Yer türü (ör. "restoran" veya "gas_station").

A Tablosu'ndan en fazla 50 tür belirtilebilir.

Müşteri hemincludeTypes (ör. restoran) hem de excludedTypes (ör. kafe) özelliklerini sağlarsa yanıt, restoran olan ancak kafe olmayan yerleri içermelidir. Yanıt, includedType'lardan en az biriyle eşleşen ve excludedType'ların hiçbiriyle eşleşen yerleri içermeyen yerler içerir.

Çakışan türler varsa, yani bir tür hem includedTypes hem de excludedTypes içinde görünüyorsa INVALID_ARGUMENT hatası döndürülür.

Bir yer türü, birden çok tür kısıtlamasıyla belirtilirse, yalnızca tüm kısıtlamaları karşılayan yerler döndürülür. Örneğin, {includedTypes = ["Restaurant"], excludedPrimaryTypes = ["lokanta"]} bulunuyorsa döndürülen yerler "restoran" ile ilgili hizmetler sağlar ancak esas olarak "restoran" olarak faaliyet göstermez.
includedPrimaryTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresinden sağlanan birincil yer türü (ör. "restoran" veya "gas_station"). Bir yerin, kendisiyle ilişkili desteklenen türler tablosundan yalnızca tek bir birincil türü olabilir.

A Tablosu'ndan en fazla 50 tür belirtilebilir.

Çakışan birincil türler varsa (ör. bir tür hemincludePrimaryTypes hem de excludedPrimaryTypes özelliğinde görünüyorsa) INVALID_ARGUMENT hatası döndürülür.

Bir yer türü, birden çok tür kısıtlamasıyla belirtilirse, yalnızca tüm kısıtlamaları karşılayan yerler döndürülür. Örneğin, {includedTypes = ["Restaurant"], excludedPrimaryTypes = ["lokanta"]} bulunuyorsa döndürülen yerler "restoran" ile ilgili hizmetler sağlar ancak esas olarak "restoran" olarak faaliyet göstermez.
excludedPrimaryTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresinden hariç tutulan birincil yer türü (ör. "restoran" veya "gas_station").

A Tablosu'ndan en fazla 50 tür belirtilebilir.

Çakışan birincil türler varsa (ör. bir tür hemincludePrimaryTypes hem de excludedPrimaryTypes özelliğinde görünüyorsa) INVALID_ARGUMENT hatası döndürülür.

Bir yer türü, birden çok tür kısıtlamasıyla belirtilirse, yalnızca tüm kısıtlamaları karşılayan yerler döndürülür. Örneğin, {includedTypes = ["Restaurant"], excludedPrimaryTypes = ["lokanta"]} bulunuyorsa döndürülen yerler "restoran" ile ilgili hizmetler sağlar ancak esas olarak "restoran" olarak faaliyet göstermez.
maxResultCount

integer

Döndürülecek maksimum sonuç sayısı. Bu değer 1 ile 20 (varsayılan) arasında (varsayılan) olmalıdır. Değer ayarlanmazsa üst sınıra geri döner. Sayı negatif olarak ayarlanırsa veya üst sınırı aşarsa bir INVALID_ARGUMENT hatası döndürülür.
locationRestriction

object (LocationRestriction)

Zorunlu. Aranacak bölge.
rankPreference

enum (RankPreference)

Sonuçlar yanıtta nasıl sıralanır?

Yanıt gövdesi

Yakında Arama için yanıt protokolü.

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

JSON gösterimi 
{
  "places": [
    {
      object (Place)
    }
  ]
}
Alanlar
places[]

object (Place)

Yer türleri, yer sayısı ve belirli konum kısıtlaması gibi kullanıcının gereksinimlerini karşılayan yerlerin listesi.

LocationRestriction

Aranacak bölge.

JSON gösterimi 
{

  // Union field type can be only one of the following:
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Alanlar

type alanı.

type şunlardan yalnızca biri olabilir:
circle

object (Circle)

Merkez noktası ve yarıçapla tanımlanan bir çember.

RankPreference

Sonuçlar yanıtta nasıl sıralanır?

Sıralamalar
RANK_PREFERENCE_UNSPECIFIED RankPreference değeri ayarlanmadı. Varsayılan olarak POPULARITY'ye göre sıralama kullanılacak.
DISTANCE Sonuçları mesafeye göre sıralar.
POPULARITY Sonuçları popülerliğe göre sıralar.