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ıya sahip verileri 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

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

Desteklenen dillerin mevcut 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 sayfasına 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 eklenen Yer türü (ör. "restoran" veya "benzin istasyonu").

Tablo A'dan en fazla 50 tür belirtilebilir.

Çakışan türler varsa (ör. bir tür hemincludeTypes hem de excludedTypes içinde gösteriliyorsa) 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 = ["restoran"], hariç tutulanPrimaryTypes = ["restoran"]} varsa döndürülen yerlerde "restoran" değeri verilir. bağlantılı hizmetler sunan ancak birincil olarak "restoran" olarak faaliyet göstermeyen.
excludedTypes[]

string

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

Tablo A'dan en fazla 50 tür belirtilebilir.

Müşteri hemincludeTypes (ör. restoran) hem de excludedTypes (ör. kafe) sağlarsa yanıt, restorana ait olan ancak kafe dışındaki yerleri içermelidir. Yanıt, includeType'ların en az biriyle eşleşen ve excludedType'ların hiçbiriyle eşleşen yerleri içermez.

Çakışan türler varsa (ör. bir tür hemincludeTypes hem de excludedTypes içinde gösteriliyorsa) 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 = ["restoran"], hariç tutulanPrimaryTypes = ["restoran"]} varsa döndürülen yerlerde "restoran" değeri verilir. bağlantılı hizmetler sunan ancak birincil olarak "restoran" olarak faaliyet göstermeyen.
includedPrimaryTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresinden birincil yer türü (ör. "restoran" veya "gaz_station") eklendi. Bir yer, kendisiyle ilişkilendirilmiş desteklenen türler tablosundan yalnızca tek bir birincil türe sahip olabilir.

Tablo A'dan en fazla 50 tür belirtilebilir.

Çakışan birincil türler varsa (ör. hem dahil edilenBirincilTypes hem de excludedPrimaryTypes içinde yer alan bir tür) 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 = ["restoran"], hariç tutulanPrimaryTypes = ["restoran"]} varsa döndürülen yerlerde "restoran" değeri verilir. bağlantılı hizmetler sunan ancak birincil olarak "restoran" olarak faaliyet göstermeyen.
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").

Tablo A'dan en fazla 50 tür belirtilebilir.

Çakışan birincil türler varsa (ör. hem dahil edilenBirincilTypes hem de excludedPrimaryTypes içinde yer alan bir tür) 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 = ["restoran"], hariç tutulanPrimaryTypes = ["restoran"]} varsa döndürülen yerlerde "restoran" değeri verilir. bağlantılı hizmetler sunan ancak birincil olarak "restoran" olarak faaliyet göstermeyen.
maxResultCount

integer

Döndürülecek maksimum sonuç sayısı. Bu değer, 1 ile 20 (varsayılan) arasında (bu değerler dahil) olmalıdır. Sayı ayarlanmazsa üst sınıra geri döner. Sayı negatif olarak ayarlanırsa veya üst sınırı aşarsa bir GEÇERSİZ_BAĞ_DEĞER hatası döndürülür.
locationRestriction

object (LocationRestriction)

Zorunlu. Aranacak bölge.
rankPreference

enum (RankPreference)

Sonuçların yanıtta sıralanma şekli.

Yanıt gövdesi

Yakında Ara 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ürü, yer sayısı ve belirli konum kısıtlamaları gibi kullanıcı gereksinimlerini karşılayan yerlerin bir 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

Birleştirme alanı type.

type şunlardan yalnızca biri olabilir:
circle

object (Circle)

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

RankPreference

Sonuçların yanıtta sıralanma şekli.

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