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 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 özgü yer adı gibi yer ayrıntılarını görüntülemek için kullanılır. Parametre, geçerli yasaya 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 alınan dahil edilen yer türü (ör. "restaurant" veya "gas_station").

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

Ç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.
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, includedTypes parametresinden en az biriyle eşleşen ve excludedTypes parametresinden hiçbiriyle eşleşmeyen yerleri içerir.

Ç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. "restaurant" veya "gas_station").

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.
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 INVALID_ARGUMENT 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. Rota özeti, yerlerden biri için kullanılamıyorsa boş bir giriş içerir. Bu listede, istenen durumlarda yer listesi kadar giriş bulunmalıdır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform

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 RankPreference değeri ayarlanmadı. Varsayılan olarak POPÜLERLİĞE göre sıralama kullanılır.
DISTANCE Sonuçları mesafeye göre sıralar.
POPULARITY Sonuçları popülerliğe göre sıralar.