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 ( |
Alanlar | |
---|---|
languageCode |
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 |
İ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[] |
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[] |
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[] |
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[] |
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 |
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 |
Zorunlu. Aranacak bölge. |
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 ( |
Alanlar | |
---|---|
places[] |
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 |
Alanlar | |
---|---|
|
|
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. |