Method: places.searchNearby

Yerlere yakın 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 metni aşağıdaki yapıyla birlikte 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),
  "routingParameters": {
    object (RoutingParameters)
  }
}
Alanlar
languageCode

string

Yer ayrıntıları, varsa tercih edilen dilde gösterilir. Dil kodu belirtilmemişse veya tanınmamışsa herhangi bir dilde yer ayrıntıları döndürülebilir. Bu tür ayrıntılar varsa öncelik İngilizceye verilir.

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

string

İsteğin gönderildiğ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ı şu anda desteklenmemektedir.
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örünüyorsa) INVALID_ARGUMENT hatası döndürülür.

Bir yer türü birden fazla 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 = ["restaurant"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sunar ancak öncelikle "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. "restaurant" veya "gas_station").

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

Müşteri hem dahil edilen türleri (ör. restoran) hem de hariç tutulan türleri (ör. kafe) sağlarsa yanıtta restoran olan ancak kafe olmayan yerler yer almalıdır. 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ür varsa (ör. 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 fazla 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 = ["restaurant"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sunar ancak öncelikle "restoran" olarak faaliyet göstermez.
includedPrimaryTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresinden dahil edilen birincil yer türü (ör. "restaurant" veya "gas_station"). Bir yerin, desteklenen türler tablosundaki yalnızca tek bir birincil türü olabilir.

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

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

Bir yer türü birden fazla 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 = ["restaurant"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sunar ancak öncelikle "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").

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 fazla 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 = ["restaurant"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sunar ancak öncelikle "restoran" olarak faaliyet göstermez.
maxResultCount

integer

Döndürülecek maksimum sonuç sayısı. 1 ile 20 (varsayılan) arasında olmalıdır. Sayı ayarlanmadıysa ü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 nasıl sıralanacağı.
routingParameters

object (RoutingParameters)

İsteğe bağlı. Arama sonuçlarına yönlendirmeyi etkileyen parametreler.

Yanıt gövdesi

Yakındakileri Arama için yanıt protosu.

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

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

object (Place)

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

object (RoutingSummary)

Her girişin places alanındaki aynı dizindeki ilgili yerle ilişkilendirildiği yönlendirme özetlerinin listesi. Yerlerden biri için yönlendirme özeti kullanılamıyorsa boş bir giriş içerir. Bu listede, istenen durumlarda yer listesi kadar giriş bulunmalıdır.

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

Birlik alanı type.

type yalnızca aşağıdakilerden biri olabilir:
circle

object (Circle)

Merkez noktası ve yarıçapı ile tanımlanan bir daire.

RankPreference

Sonuçların yanıtta nasıl sıralanacağı.

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.