Method: places.searchNearby

Konumların yakınındaki yerleri arama

HTTP isteği

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

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 
{
  "languageCode": string,
  "regionCode": string,
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ],
  "maxResultCount": integer,
  "locationRestriction": {
    object (LocationRestriction)
  },
  "rankPreference": enum (RankPreference),
  "routingParameters": {
    object (RoutingParameters)
  },
  "includeFutureOpeningBusinesses": boolean
}
Alanlar
languageCode

string

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

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

string

Talebin 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östermek 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ının şu anda desteklenmediğini unutmayın.
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ürler 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 öncelikli 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. "restaurant" veya "gas_station").

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

İstemci hem includedTypes (ör. restoran) hem de excludedTypes (ör. kafe) sağlıyorsa yanıtta restoran olan ancak kafe olmayan yerler yer almalıdır. Yanıtta, includedTypes'lardan en az biriyle eşleşen ve excludedTypes'lardan hiçbiriyle eşleşmeyen yerler yer alır.

Çakışan türler 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 öncelikli olarak "restoran" olarak faaliyet göstermez.
includedPrimaryTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki dahil edilen birincil Yer türü (ör. "restaurant" veya "gas_station"). Bir yer, desteklenen türler tablosunda yer alan türlerden yalnızca biriyle ilişkilendirilebilir.

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 öncelikli 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. "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 öncelikli olarak "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ı ayarlanmamışsa ü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.
includeFutureOpeningBusinesses

boolean

İsteğe bağlı. Doğruysa henüz açık olmayan ancak gelecekte açılacak işletmeleri dahil edin.

Yanıt metni

Yakında 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ı şartlarını karşılayan yerlerin listesi.
routingSummaries[]

object (RoutingSummary)

Her girişin places alanındaki aynı dizinde karşılık gelen yerle ilişkilendirildiği yönlendirme özetlerinin listesi. Yönlendirme özeti yerlerden biri için kullanılamıyorsa boş bir giriş içerir. Bu listede, istenirse yer listesindeki kadar giriş olmalı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

type birleşik alanı.

type aşağıdakilerden yalnızca 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.