Package google.maps.places.v1

Dizin

Yerler

Places API için hizmet tanımı. Not: Her istek (Otomatik tamamlama istekleri hariç) için istek protokolünün dışında ayarlanmış bir alan maskesi gerekir (all/* olduğu varsayılmaz). Alan maskesi, X-Goog-FieldMask HTTP üstbilgisi aracılığıyla ayarlanabilir. Şu sayfaya bakın: https://developers.google.com/maps/documentation/places/web-service/choose-fields

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

Belirli bir giriş için tahminleri döndürür.

GetPhotoMedia

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

Fotoğraf referans dizesi içeren bir fotoğraf medyası alın.

GetPlace

rpc GetPlace(GetPlaceRequest) returns (Place)

places/{place_id} biçiminde bir dize olan kaynak adına göre bir yerle ilgili ayrıntıları öğrenin.

SearchNearby

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

Konumların yakınındaki yerleri arayın.

SearchText

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Metin sorgusuna dayalı yer arama.

AuthorAttribution

Kullanıcı tarafından oluşturulan içerik verilerinin yazarı hakkında bilgiler. Photo ve Review kullanıldı.

Alanlar
display_name

string

Photo veya Review yazarının adı.

uri

string

Photo veya Review yazarının URI'si.

photo_uri

string

Photo veya Review yazarının profil fotoğrafı URI'si.

AutocompletePlacesRequest

AutocompletePlaces için protokol isteyin.

Alanlar
input

string

Zorunlu. Arama yapılacak metin dizesi.

location_bias

LocationBias

İsteğe bağlı. Belirli bir yerle ilgili önyargı sonuçları.

En fazla location_bias veya location_restriction ayarlanmalıdır. İkisi de ayarlanmazsa sonuçlara IP adresine göre ağırlık verilir, yani IP adresi tam olmayan bir konumla eşlenir ve ağırlık verme sinyali olarak kullanılır.

location_restriction

LocationRestriction

İsteğe bağlı. Sonuçları belirli bir konumla sınırlandır.

En fazla location_bias veya location_restriction ayarlanmalıdır. İkisi de ayarlanmazsa sonuçlara IP adresine göre ağırlık verilir, yani IP adresi tam olmayan bir konumla eşlenir ve ağırlık verme sinyali olarak kullanılır.

included_primary_types[]

string

İsteğe bağlı. https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki birincil yer türü (örneğin, "restoran" veya "gas_station") eklendi. Bir yer, yalnızca birincil türü bu listede yer alıyorsa döndürülür. En fazla 5 değer belirtilebilir. Hiçbir tür belirtilmezse tüm Yer türleri döndürülür.

included_region_codes[]

string

İsteğe bağlı. Yalnızca belirtilen bölgelerdeki sonuçları dahil edin (en fazla 15 CLDR iki karakterli bölge koduyla belirtilir). Boş bir küme sonuçları kısıtlamaz. Hem location_restriction hem de included_region_codes ayarlanırsa sonuçlar kesişim alanında bulunur.

language_code

string

İsteğe bağlı. Sonuçların döndürüleceği dil. Varsayılan olarak en-US değerine ayarlanır. input dilinde kullanılan dil language_code dilinden farklıysa veya döndürülen yerin yerel dilden language_code diline çevirisi yoksa sonuçlar karışık olabilir.

region_code

string

İsteğe bağlı. CLDR iki karakterli bölge kodu olarak belirtilen bölge kodu. Bu, adres biçimlendirmesini ve sonuç sıralamasını etkiler ve hangi sonuçların döndürüleceğini etkileyebilir. Bu işlem, sonuçları belirtilen bölgeyle kısıtlamaz. Sonuçları bir bölgeyle kısıtlamak için region_code_restriction özelliğini kullanın.

origin

LatLng

İsteğe bağlı. Hedefe olan jeodezik mesafenin hesaplanacağı başlangıç noktası (distance_meters olarak döndürülür). Bu değer atlanırsa, jeodezik mesafe döndürülmez.

input_offset

int32

İsteğe bağlı. İmleç konumunu input olarak gösteren, input sıfır tabanlı Unicode karakter ofseti. İmleç konumu, hangi tahminlerin döndürüleceğini etkileyebilir.

Boş bırakılırsa varsayılan olarak input uzunluğu ayarlanır.

include_query_predictions

bool

İsteğe bağlı. Doğru ise, yanıt hem Yer hem de sorgu tahminlerini içerir. Aksi takdirde, yanıt yalnızca Yer tahminleri döndürür.

session_token

string

İsteğe bağlı. Faturalandırma amacıyla bir Otomatik Tamamlama oturumunu tanımlayan dize. En fazla 36 ASCII karakter uzunluğunda bir URL ve dosya adı güvenli base64 dizesi olmalıdır. Aksi takdirde bir INVALID_ARGUMENT hatası döndürülür.

Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve kullanıcı bir yer seçip Yer Ayrıntıları veya Adres Doğrulama çağrısı yapıldığında sona erer. Her oturumda birden fazla sorgu ve ardından bir Yer Ayrıntıları veya Adres Doğrulama isteği gelebilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Oturum sona erdiğinde jeton artık geçerli olmaz; uygulamanızın her oturum için yeni bir jeton oluşturması gerekir. session_token parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Aşağıdaki yönergeleri öneririz:

  • Tüm otomatik yer tamamlama çağrıları için oturum jetonlarını kullanın.
  • Her oturum için yeni bir jeton oluşturun. Sürüm 4 UUID kullanmanız önerilir.
  • Bir oturumdaki tüm Yer Otomatik Tamamlama, Yer Ayrıntıları ve Adres Doğrulama istekleri için kullanılan kimlik bilgilerinin aynı Cloud Console projesine ait olduğundan emin olun.
  • Her yeni oturum için benzersiz bir oturum jetonu ilettiğinizden emin olun. Aynı jetonun birden fazla oturumda kullanılması, her isteğin ayrı ayrı faturalandırılmasına neden olur.

LocationBias

Aranacak bölge. Sonuçlar, belirtilen bölge çevresinde sapma gösterebilir.

Alanlar

Birleştirme alanı type.

type şunlardan yalnızca biri olabilir:

rectangle

Viewport

Bir kuzeydoğu ve güneybatı köşesiyle tanımlanan görüntü alanı.

circle

Circle

Bir merkez noktası ve yarıçapla tanımlanan bir daire.

LocationRestriction

Aranacak bölge. Sonuçlar, belirtilen bölgeyle kısıtlanır.

Alanlar

Birleştirme alanı type.

type şunlardan yalnızca biri olabilir:

rectangle

Viewport

Bir kuzeydoğu ve güneybatı köşesiyle tanımlanan görüntü alanı.

circle

Circle

Bir merkez noktası ve yarıçapla tanımlanan bir daire.

AutocompletePlacesResponse

AutocompletePlaces için yanıt protokolü.

Alanlar
suggestions[]

Suggestion

Alaka düzeyine göre azalan düzende sıralanmış bir öneriler listesi içerir.

Öneri

Otomatik tamamlama öneri sonucu.

Alanlar

Birleştirme alanı kind.

kind şunlardan yalnızca biri olabilir:

place_prediction

PlacePrediction

Bir yer için tahmin.

query_prediction

QueryPrediction

Bir sorgu için tahmin.

FormattableText

Bir yer veya sorgu tahminini temsil eden metin. Metin, olduğu gibi veya biçimlendirilmiş olarak kullanılabilir.

Alanlar
text

string

Olduğu gibi kullanılabilecek veya matches ile biçimlendirilebilecek metin.

matches[]

StringRange

Giriş isteğinin text içinde eşleştiği yeri tanımlayan dize aralıklarının listesi. Aralıklar, text öğesinin belirli bölümlerini biçimlendirmek için kullanılabilir. Eşleşme, dize eşleştirme dışındaki bir ölçüte göre belirlendiyse (örneğin, yazım düzeltmeleri veya harf çevirileri) alt dizeler input ile tam eşleşmeler olmayabilir.

Bu değerler, text özelliğinin Unicode karakter ofsetleridir. Aralıkların, artan ofset değerleriyle sıralanması garanti edilir.

PlacePrediction

Otomatik Yer Tamamlama tahmini için tahmin sonuçları.

Alanlar
place

string

Önerilen yerin kaynak adı. Bu ad, Yer adlarını kabul eden diğer API'lerde kullanılabilir.

place_id

string

Önerilen yerin benzersiz tanımlayıcısı. Bu tanımlayıcı, Yer Kimliklerini kabul eden diğer API'lerde kullanılabilir.

text

FormattableText

Döndürülen sonucun kullanıcılar tarafından okunabilen adını içerir. Kuruluş sonuçları için bu genellikle işletme adı ve adresidir.

text, tek bir kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler için önerilir. İki ayrı ancak birbiriyle alakalı kullanıcı arayüzü öğeleri göstermek isteyen geliştiriciler bunun yerine structured_format kullanabilirler. Bunlar, bir yer tahminini temsil etmenin iki farklı yoludur. Kullanıcılar structured_format öğesini text veya tam tersi şekilde ayrıştırmaya çalışmamalıdır.

Bu metin, GetPlace tarafından döndürülen display_name metinden farklı olabilir.

input ve language_code isteği farklı dillerdeyse veya yerin yerel dilden language_code diline çevirisi yoksa karma dillerde olabilir.

structured_format

StructuredFormat

Yer tahmininin, Yerin adını içeren ana metin ve belirsizleştirilmiş ek özellikler (şehir veya bölge gibi) içeren ikincil metin olarak dökümü.

structured_format, birbiriyle alakalı iki ayrı kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler için önerilir. Tek bir kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler bunun yerine text kullanmayı tercih edebilirler. Bunlar, bir yer tahminini temsil etmenin iki farklı yoludur. Kullanıcılar structured_format öğesini text veya tam tersi şekilde ayrıştırmaya çalışmamalıdır.

types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki Tablo A veya Tablo B'den bu Yer için geçerli olan türlerin listesi.

Tür, Yer için yapılan bir kategorilendirmedir. Ortak türlere sahip yerler de benzer özelliklere sahiptir.

distance_meters

int32

origin belirtilmişse origin ile mesafenin metre cinsinden jeodezik uzunluğu. Rotalar gibi belirli tahminler bu alanı doldurmayabilir.

QueryPrediction

Otomatik Sorgu Tamamlama tahmini için tahmin sonuçları.

Alanlar
text

FormattableText

Tahmin edilen metin. Bu metin bir yeri değil, arama uç noktasında (örneğin, Metin Arama) kullanılabilen bir metin sorgusunu temsil etmektedir.

text, tek bir kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler için önerilir. İki ayrı ancak birbiriyle alakalı kullanıcı arayüzü öğeleri göstermek isteyen geliştiriciler bunun yerine structured_format kullanabilirler. Bunlar, bir sorgu tahminini temsil etmenin iki farklı yoludur. Kullanıcılar structured_format öğesini text veya tam tersi şekilde ayrıştırmaya çalışmamalıdır.

input ve language_code isteği farklı dillerdeyse veya sorgunun bir kısmının yerel dilden language_code diline çevirisi yoksa karma dillerde olabilir.

structured_format

StructuredFormat

Sorgu tahmininin, sorguyu içeren ana metin ve kesinleştirici ek özellikler (şehir veya bölge gibi) içeren ikincil metin olarak dökümü.

structured_format, birbiriyle alakalı iki ayrı kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler için önerilir. Tek bir kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler bunun yerine text kullanmayı tercih edebilirler. Bunlar, bir sorgu tahminini temsil etmenin iki farklı yoludur. Kullanıcılar structured_format öğesini text veya tam tersi şekilde ayrıştırmaya çalışmamalıdır.

StringRange

Belirli bir metin içindeki bir alt dizeyi tanımlar.

Alanlar
start_offset

int32

Dizenin ilk Unicode karakterinin (dahil) sıfır tabanlı ofseti.

end_offset

int32

Son Unicode karakterinin sıfır tabanlı ofseti (hariç).

StructuredFormat

Bir yer veya sorgu tahmininin ana ve ikincil metne dökümünü içerir.

Yer tahminleri için, ana metin Yerin adını içerir. Sorgu tahminleri için ana metin sorguyu içerir.

İkincil metin, Yeri daha iyi tanımlamak veya sorguyu ayrıntılandırmak için açıklayıcı ek özellikler (şehir veya bölge gibi) içerir.

Alanlar
main_text

FormattableText

Yerin veya sorgunun adını temsil eder.

secondary_text

FormattableText

Yeri daha iyi tanımlamak veya sorguyu ayrıntılandırmak için açıklayıcı ek özellikleri (şehir veya bölge gibi) temsil eder.

Daire

Merkez ve yarıçapı LatLng olan çember

Alanlar
center

LatLng

Zorunlu. Merkez enlemi ve boylamı.

Enlem aralığı [-90.0, 90.0] dahilinde olmalıdır. Boylam aralığı [-180.0, 180.0] dahilinde olmalıdır.

radius

double

Zorunlu. Metre cinsinden ölçülen yarıçap. Yarıçap [0.0, 50000.0] dahilinde olmalıdır.

ContentBlock

Ayrı olarak sunulabilecek bir içerik bloğu.

Alanlar
topic

string

İçeriğin konusu. Örneğin, "genel bakış" veya "restoran".

content

LocalizedText

Konuyla ilgili içerik.

references

References

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Bu içerik bloğuyla ilgili referanslar.

ContextualContent

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yer sorgusuyla alakalı içerik.

Alanlar
reviews[]

Review

Bu yerle ilgili, yer sorgusuyla ilişkili yorumların listesi.

photos[]

Photo

Bu yerin fotoğrafları hakkında, yer sorgusu ile ilişkili bilgiler (referanslar dahil).

justifications[]

Justification

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yerle ilgili gerekçeler.

Gerekçe

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yerle ilgili gerekçeler. Gerekçeler, bir yerin son kullanıcının neden ilgisini çekebileceği sorusunu yanıtlar.

Alanlar

Birleştirme alanı justification.

justification şunlardan yalnızca biri olabilir:

review_justification

ReviewJustification

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

business_availability_attributes_justification

BusinessAvailabilityAttributesJustification

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

BusinessAvailabilityAttributesJustification

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin. BusinessAvailabilityAttributes gerekçeleri. Bu, bir işletmenin son kullanıcıların ilgisini çekebilecek bazı özelliklerini gösterir.

Alanlar
takeout

bool

Bir yerde paket servisi olup olmadığı.

delivery

bool

Bir yerin teslimat yapıp yapmadığı.

dine_in

bool

Bir yerde içeride yemek servisi yapılıp yapılmadığı.

ReviewJustification

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Kullanıcı yorumu gerekçeleri. Bu bölüm, kullanıcı yorumunun son kullanıcının ilgisini çekecek bir bölümünü vurgular. Örneğin, arama sorgusu "odun ateşinde pizza" ise yorum gerekçesi, arama sorgusuyla alakalı metni vurgular.

Alanlar
highlighted_text

HighlightedText

review

Review

Vurgulanan metnin oluşturulduğu yorum.

HighlightedText

Gerekçeyle vurgulanan metin. Bu, yorumun bir alt kümesidir. Vurgulanacak kelime tam olarak VurgulananTextRange ile işaretlenir. Vurgulanan metinde birkaç kelime olabilir.

Alanlar
text

string

highlighted_text_ranges[]

HighlightedTextRange

Vurgulanan metindeki aralıklar listesi.

HighlightedTextRange

Vurgulanan metin aralığı.

Alanlar
start_index

int32

end_index

int32

EVChargeOptions

Yerinde barındırılan EV Şarj İstasyonu hakkında bilgi. https://afdc.energy.gov/fuels/electricity_infrastructure.html terminolojisine göre bir bağlantı noktası aynı anda bir arabayı şarj edebilir. Bir bağlantı noktasında bir veya daha fazla bağlayıcı vardır. Bir istasyonun bir veya daha fazla bağlantı noktası vardır.

Alanlar
connector_count

int32

Bu istasyondaki konnektör sayısı. Bununla birlikte, bazı bağlantı noktalarında birden fazla konnektör bulunabileceği ancak aynı anda yalnızca bir arabayı şarj edebildiği için (ör.) konnektörlerin sayısı, aynı anda şarj edilebilen toplam araba sayısından daha fazla olabilir.

connector_aggregation[]

ConnectorAggregation

Aynı türde ve aynı şarj hızında konnektörler içeren EV şarj konnektörü toplama listesi.

ConnectorAggregation

Elektrikli araç şarj bilgileri [tür, maks.şarj_oranı_kw] değerine göre gruplandırılmıştır. Aynı türde ve maksimum şarj oranına kw cinsinden sahip olan konnektörlerin EV şarj toplamını gösterir.

Alanlar
type

EVConnectorType

Bu toplamanın bağlayıcı türü.

max_charge_rate_kw

double

Toplamadaki her bir bağlayıcının kw cinsinden statik maksimum şarj hızı.

count

int32

Bu toplamadaki bağlayıcı sayısı.

availability_last_update_time

Timestamp

Bu toplamadaki bağlayıcı kullanılabilirlik bilgilerinin en son güncellendiği zaman damgası.

available_count

int32

Bu toplamada şu anda kullanılabilir olan bağlayıcı sayısı.

out_of_service_count

int32

Bu toplamadaki şu anda hizmet dışı olan bağlayıcı sayısı.

EVConnectorType

EV şarj konnektörü türleri hakkında ek bilgi/bağlam için http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 adresine bakın.

Sıralamalar
EV_CONNECTOR_TYPE_UNSPECIFIED Belirtilmemiş bağlayıcı.
EV_CONNECTOR_TYPE_OTHER Diğer bağlayıcı türleri.
EV_CONNECTOR_TYPE_J1772 J1772 tip 1 bağlayıcı.
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 tip 2 konnektör. Genellikle MENNEKES olarak adlandırılır.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO türü bağlayıcıyla çalışır.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Birleşik Şarj Sistemi (AC ve DC). SAE'ye göre. Tip-1 J-1772 konnektör
EV_CONNECTOR_TYPE_CCS_COMBO_2 Birleşik Şarj Sistemi (AC ve DC). Type-2 Mennekes bağlayıcısına göre
EV_CONNECTOR_TYPE_TESLA Genel TESLA bağlayıcısı. Kuzey Amerika'da NACS olmasına rağmen dünyanın diğer bölgelerinde NACS olmayan numara (ör. CCS Kombine 2 (CCS2) veya GB/T) olabilir. Bu değer, gerçek konnektör türünü daha az temsil eder ve daha çok, Tesla markalı bir aracı, Tesla'ya ait bir şarj istasyonunda şarj etme olanağını temsil eder.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T GB/T türü, Çin'deki GB/T standardına karşılık gelir. Bu tür, tüm GB_T türlerini kapsar.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Belirtilmemiş duvar prizi.

FuelOptions

Bir benzin istasyonundaki yakıt seçenekleriyle ilgili en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir.

Alanlar
fuel_prices[]

FuelPrice

Bu istasyonun her yakıt türü için bilinen son yakıt fiyatı. Bu istasyonda her yakıt türü için bir giriş bulunuyor. Sıra önemli değil.

FuelPrice

Belirli bir tür için yakıt fiyatı bilgileri.

Alanlar
type

FuelType

Yakıt türü.

price

Money

Yakıtın fiyatı.

update_time

Timestamp

Yakıt fiyatının son güncellendiği zaman.

FuelType

Yakıt türleri.

Sıralamalar
FUEL_TYPE_UNSPECIFIED Yakıt türü belirtilmedi.
DIESEL Dizel yakıt.
REGULAR_UNLEADED Normal öncülüksüz.
MIDGRADE 89 Oktan'a dokunun.
PREMIUM Premium.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG LPG
E80 E 80.
E85 E 85.
METHANE Metan.
BIO_DIESEL Biyodizel.
TRUCK_DIESEL Kamyon dizel.

GetPhotoMediaRequest

Fotoğraf kaynağı adı kullanarak bir yerin fotoğrafını getirme isteği.

Alanlar
name

string

Zorunlu. Fotoğraf medyasının şu biçimdeki kaynak adı: places/{place_id}/photos/{photo_reference}/media.

Bir yer nesnesinin photos.name alanında döndürülen şekliyle fotoğrafın kaynak adı places/{place_id}/photos/{photo_reference} biçimine sahiptir. Fotoğraf medya kaynağı adını almak için fotoğraf kaynağının sonuna /media eklemeniz gerekir.

max_width_px

int32

İsteğe bağlı. Resmin istenen maksimum genişliğini piksel cinsinden belirtir. Resim belirtilen değerlerden küçükse orijinal resim döndürülür. Resim iki boyuttan birinde daha büyükse, orijinal en boy oranıyla sınırlı olmak üzere iki boyuttan küçük olanına uyacak şekilde ölçeklendirilir. Hem max_height_px hem de max_width_px özellikleri, 1 ile 4800 arasında (1 ve 4800 dahil) bir tam sayı kabul eder. Değer izin verilen aralıkta değilse INVALID_ARGUMENT hatası döndürülür.

max_height_px veya max_width_px değerlerinden en az biri belirtilmelidir. max_height_px veya max_width_px belirtilmezse INVALID_ARGUMENT hatası döndürülür.

max_height_px

int32

İsteğe bağlı. Resmin istenen maksimum yüksekliğini piksel cinsinden belirtir. Resim belirtilen değerlerden küçükse orijinal resim döndürülür. Resim iki boyuttan birinde daha büyükse, orijinal en boy oranıyla sınırlı olmak üzere iki boyuttan küçük olanına uyacak şekilde ölçeklendirilir. Hem max_height_px hem de max_width_px özellikleri, 1 ile 4800 arasında (1 ve 4800 dahil) bir tam sayı kabul eder. Değer izin verilen aralıkta değilse INVALID_ARGUMENT hatası döndürülür.

max_height_px veya max_width_px değerlerinden en az biri belirtilmelidir. max_height_px veya max_width_px belirtilmezse INVALID_ARGUMENT hatası döndürülür.

skip_http_redirect

bool

İsteğe bağlı. Ayarlanırsa varsayılan HTTP yönlendirme davranışını atlayın ve bir metin biçimi (örneğin, HTTP kullanım durumu için JSON biçiminde) yanıtı oluşturun. Politika ayarlanmazsa çağrıyı resim medyasına yönlendirmek için bir HTTP yönlendirmesi verilir. Bu seçenek, HTTP olmayan istekler için yoksayılır.

GetPlaceRequest

Kaynak adına (places/{place_id} biçiminde bir dize) göre bir Yer getirme isteği.

Alanlar
name

string

Zorunlu. Bir yerin places/{place_id} biçimindeki kaynak adı.

language_code

string

İsteğe bağlı. Yer ayrıntıları varsa, tercih edilen dilde görüntülenir.

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

region_code

string

İsteğe bağlı. İsteğin geldiğ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 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.

session_token

string

İsteğe bağlı. Faturalandırma amacıyla bir Otomatik Tamamlama oturumunu tanımlayan dize. En fazla 36 ASCII karakter uzunluğunda bir URL ve dosya adı güvenli base64 dizesi olmalıdır. Aksi takdirde bir INVALID_ARGUMENT hatası döndürülür.

Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve kullanıcı bir yer seçip Yer Ayrıntıları veya Adres Doğrulama çağrısı yapıldığında sona erer. Her oturumda birden fazla sorgu ve ardından bir Yer Ayrıntıları veya Adres Doğrulama isteği gelebilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Oturum sona erdiğinde jeton artık geçerli olmaz; uygulamanızın her oturum için yeni bir jeton oluşturması gerekir. session_token parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

Aşağıdaki yönergeleri öneririz:

  • Tüm otomatik yer tamamlama çağrıları için oturum jetonlarını kullanın.
  • Her oturum için yeni bir jeton oluşturun. Sürüm 4 UUID kullanmanız önerilir.
  • Bir oturumdaki tüm Yer Otomatik Tamamlama, Yer Ayrıntıları ve Adres Doğrulama istekleri için kullanılan kimlik bilgilerinin aynı Cloud Console projesine ait olduğundan emin olun.
  • Her yeni oturum için benzersiz bir oturum jetonu ilettiğinizden emin olun. Aynı jetonun birden fazla oturumda kullanılması, her isteğin ayrı ayrı faturalandırılmasına neden olur.

Fotoğraf

Bir yerin fotoğrafı hakkında bilgiler.

Alanlar
name

string

Tanımlayıcı. Bu yer fotoğrafını temsil eden ve bu yer fotoğrafını tekrar aramak için kullanılabilecek bir referans (API "kaynak" adı: places/{place_id}/photos/{photo}).

width_px

int32

Piksel cinsinden kullanılabilir maksimum genişlik.

height_px

int32

Piksel cinsinden kullanılabilir maksimum yükseklik.

author_attributions[]

AuthorAttribution

Bu fotoğrafın yazarları.

PhotoMedia

Places API'den bir fotoğraf medyası.

Alanlar
name

string

Fotoğraf medyasının şu biçimdeki kaynak adı: places/{place_id}/photos/{photo_reference}/media.

photo_uri

string

Fotoğrafı oluşturmak için kullanılabilecek kısa ömürlü bir URI.

Yer

Bir yeri temsil eden tüm bilgiler.

Alanlar
name

string

Bu Yerin places/{place_id} biçimindeki kaynak adı. Yeri aramak için kullanılabilir.

id

string

Bir yerin benzersiz tanımlayıcısıdır.

display_name

LocalizedText

Yerin, kullanıcıların okuyabileceği kısa bir açıklama olarak uygun yerelleştirilmiş adı. Örneğin, "Google Sidney", "Starbucks", "Ankara" vb.

types[]

string

Bu sonuç için bir tür etiketleri kümesi. Örneğin, "siyasi" ve "yerel bölge". Olası değerlerin tam listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki Tablo A ve Tablo B'ye bakın.

primary_type

string

Belirtilen sonucun birincil türü. Bu tür, Places API tarafından desteklenen türlerden biri olmalıdır. Örneğin, "restoran", "kafe", "havaalanı" vb. Bir yerin yalnızca tek bir birincil türü olabilir. Olası değerlerin tam listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki Tablo A ve Tablo B'ye bakın.

primary_type_display_name

LocalizedText

Birincil türün görünen adı (varsa istek diline göre yerelleştirilmiş). Olası değerlerin tam listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki Tablo A ve Tablo B'ye bakın.

national_phone_number

string

Yere ait, kullanıcıların okuyabileceği bir telefon numarası (ulusal biçimde).

international_phone_number

string

Yer için kullanıcıların okuyabileceği, uluslararası standarttaki bir telefon numarası.

formatted_address

string

Bu yer için eksiksiz, okunabilir bir adres.

short_formatted_address

string

Bu yer için kısa, kullanıcılar tarafından okunabilir bir adres.

address_components[]

AddressComponent

Her şehir düzeyi için tekrarlanan bileşenler. address_components[] dizisiyle ilgili aşağıdaki bilgilere dikkat edin: - Adres bileşenleri dizisi, biçimlendirilen_adresten daha fazla bileşen içerebilir. - Dizi, biçimlendirilen_adres özelliğinde belirtilenler dışında bir adres içeren tüm siyasi varlıkları içermeyebilir. Belirli bir adres içeren tüm siyasi oluşumları geri almak için, ters coğrafi kodlama kullanmanız ve adresin enlem/boylamını isteğe bir parametre olarak aktarmanız gerekir. - İstekler arasında yanıt biçiminin aynı kalacağı garanti edilmez. Özellikle address_components sayısı, istenen adrese göre değişir ve aynı adres için zaman içinde değişebilir. Bir bileşen, dizideki konumunu değiştirebilir. Bileşenin türü değişebilir. Daha sonraki bir yanıtta belirli bir bileşen eksik olabilir.

plus_code

PlusCode

Yerin enlem/boylam artı kodu.

location

LatLng

Bu yerin konumu.

viewport

Viewport

Yerin ortalama boyutlu bir harita üzerinde gösterilmesine uygun görüntü alanı.

rating

double

Bu yerle ilgili kullanıcı yorumlarına dayalı olarak 1,0 ile 5,0 arasında bir puan.

google_maps_uri

string

Bu yer hakkında daha fazla bilgi sağlayan bir URL.

website_uri

string

Bu yerin yetkili web sitesi (ör. işletmenin ana sayfası). Bir zincirin (ör. IKEA mağazası) yer aldığı yerler için bu, genellikle zincirin tamamının değil, bağımsız mağazanın web sitesi olacaktır.

reviews[]

Review

Bu yerle ilgili yorumların alaka düzeyine göre sıralanmış listesi. En fazla 5 yorum döndürülebilir.

regular_opening_hours

OpeningHours

Normal çalışma saatleri.

photos[]

Photo

Bu yerin fotoğrafları hakkında bilgiler (referanslar dahil). En fazla 10 fotoğraf iade edilebilir.

adr_format_address

string

Yerin adr mikro biçimindeki adresi: http://microformats.org/wiki/adr.

business_status

BusinessStatus

Yerin işletme durumu.

price_level

PriceLevel

Yerin fiyat düzeyi.

attributions[]

Attribution

Bu sonuçla birlikte gösterilmesi gereken veri sağlayıcı kümesi.

icon_mask_base_uri

string

Bir simge maskesinin kısaltılmış URL'si. Kullanıcılar, tür son eki ekleyerek farklı simge türlerine erişebilir (ör. ".svg" veya ".png").

icon_background_color

string

icon_mask için onaltılık biçimde arka plan rengi, ör. #909CE1.

current_opening_hours

OpeningHours

Önümüzdeki yedi günün (bugün dahil) çalışma saatleri. Dönem, istek tarihinde gece yarısı başlar ve altı gün sonra saat 23:59'da sona erer. Bu alan, istisnai saatlere sahip tarihler için ayarlanmış, tüm saatlerin custom_days alt alanını içerir.

current_secondary_opening_hours[]

OpeningHours

Bir işletmenin ikincil çalışma saatleri hakkındaki bilgileri de içeren, sonraki yedi gün için bir dizi giriş içerir. İkincil çalışma saatleri, işletmenin ana çalışma saatlerinden farklıdır. Örneğin, bir restoran ikincil saatleri olarak arabaya servis saatleri veya teslimat saatlerini belirtebilir. Bu alan, yerin türlerine göre önceden tanımlanmış çalışma saati türleri (DRIVE_THROUGH, PICKUP veya TakeOUT) listesinden alınan tür alt alanını doldurur. Bu alan, istisnai saatlere sahip tarihler için ayarlanmış, tüm saatlerin custom_days alt alanını içerir.

regular_secondary_opening_hours[]

OpeningHours

Bir işletmenin normal ikincil çalışma saatleri hakkında bilgi veren bir dizi giriş içerir. İkincil çalışma saatleri, işletmenin ana çalışma saatlerinden farklıdır. Örneğin, bir restoran ikincil saatleri olarak arabaya servis saatleri veya teslimat saatlerini belirtebilir. Bu alan, yerin türlerine göre önceden tanımlanmış çalışma saati türleri (DRIVE_THROUGH, PICKUP veya TakeOUT) listesinden alınan tür alt alanını doldurur.

editorial_summary

LocalizedText

Yerin özetini içerir. Özet, metin biçiminde bir genel bakıştan oluşur ve varsa bunların dil kodunu da içerir. Özet metni olduğu gibi sunulmalıdır, değiştirilemez veya değiştirilemez.

payment_options

PaymentOptions

Yerin kabul ettiği ödeme seçenekleri. Ödeme seçeneği verisi bulunmuyorsa ödeme seçeneği alanı ayarlanmaz.

parking_options

ParkingOptions

Yer tarafından sunulan otopark seçenekleri.

sub_destinations[]

SubDestination

Yerle ilgili alt hedeflerin listesi.

fuel_options

FuelOptions

Bir benzin istasyonundaki yakıt seçenekleriyle ilgili en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir.

ev_charge_options

EVChargeOptions

Şarj etme seçenekleriyle ilgili bilgiler.

generative_summary

GenerativeSummary

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yerin yapay zeka tarafından üretilmiş özeti.

area_summary

AreaSummary

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yerin bulunduğu bölgenin yapay zeka tarafından üretilmiş özeti.

utc_offset_minutes

int32

Bu yerin saat diliminin şu anda UTC ile arasındaki dakika sayısı. Bu değer, bir saatin kesirleriyle ayarlanan saat dilimlerini desteklemek için dakika cinsinden ifade edilir, ör. X saat ve 15 dakika.

user_rating_count

int32

Bu yerle ilgili (metin içeren veya içermeyen) toplam yorum sayısı.

takeout

bool

İşletmenin, paket servisini destekleyip desteklemediğini belirtir.

delivery

bool

İşletmenin teslimatı destekleyip desteklemediğini belirtir.

dine_in

bool

İşletmenin iç mekan veya açık hava oturma seçeneklerini destekleyip desteklemediğini belirtir.

curbside_pickup

bool

İşletmenin arabaya teslim almayı destekleyip desteklemediğini belirtir.

reservable

bool

Yerin rezervasyonları destekleyip desteklemediğini belirtir.

serves_breakfast

bool

Yerin kahvaltı servisi yapıp yapmadığını belirtir.

serves_lunch

bool

Yerin öğle yemeği servisi yapıp yapmadığını belirtir.

serves_dinner

bool

Yerin akşam yemeği servisi yapıp yapmadığını belirtir.

serves_beer

bool

Yerin bira servisi yapıp yapmadığını belirtir.

serves_wine

bool

Yerin şarap servisi yapıp yapmadığını belirtir.

serves_brunch

bool

Yerin brunch servisi yapıp yapmadığını belirtir.

serves_vegetarian_food

bool

Yerin vejetaryen yemek servisi yapıp yapmadığını belirtir.

outdoor_seating

bool

Mekanın açık havada oturma alanı vardır.

live_music

bool

Burada canlı müzik programı vardır.

menu_for_children

bool

Mekanda çocuk menüsü vardır.

serves_cocktails

bool

Mekanda kokteyl servisi yapılır.

serves_dessert

bool

Tesiste tatlı servisi vardır.

serves_coffee

bool

Burada kahve servisi vardır.

good_for_children

bool

Burası çocuklar için iyi bir yer.

allows_dogs

bool

Burada köpeklere izin veriliyor.

restroom

bool

Yerde tuvalet var.

good_for_groups

bool

Yer, grupları barındırır.

good_for_watching_sports

bool

Burası spor müsabakaları izlemek için uygun.

accessibility_options

AccessibilityOptions

Bir yerin sunduğu erişilebilirlik seçenekleri hakkında bilgiler.

AccessibilityOptions

Bir yerin sunduğu erişilebilirlik seçenekleri hakkında bilgiler.

Alanlar
wheelchair_accessible_parking

bool

Burada tekerlekli sandalyeye uygun park yeri mevcuttur.

wheelchair_accessible_entrance

bool

Mekanların tekerlekli sandalyeye uygun girişi vardır.

wheelchair_accessible_restroom

bool

Burada tekerlekli sandalyeye uygun tuvalet var.

wheelchair_accessible_seating

bool

Burada tekerlekli sandalyeye uygun oturma düzeni vardır.

AddressComponent

Bilgi varsa biçimlendirilmiş adresi oluşturan yapılandırılmış bileşenler.

Alanlar
long_text

string

Adres bileşeninin tam metin açıklaması veya adı. Örneğin, Avustralya'ya ait bir adres bileşeninin uzun_adı "Avustralya" olabilir.

short_text

string

Varsa adres bileşeni için kısaltılmış metin adı. Örneğin, Avustralya ülkesine ait bir adres bileşeninde "AU" kısa adı olabilir.

types[]

string

Adres bileşeninin türlerini gösteren dizi.

language_code

string

Bu bileşenleri biçimlendirmek için kullanılan dil (CLDR gösterimi).

AreaSummary

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yerin bulunduğu bölgenin yapay zeka tarafından üretilmiş özeti.

Alanlar
content_blocks[]

ContentBlock

Alan özetini oluşturan içerik blokları. Her blokun, alanla ilgili ayrı bir konusu vardır.

İlişkilendirme

Bu yerin veri sağlayıcıları hakkında bilgiler.

Alanlar
provider

string

Yer'in veri sağlayıcısının adı.

provider_uri

string

Yerin veri sağlayıcısının URI'sı.

BusinessStatus

Yerin işletme durumu.

Sıralamalar
BUSINESS_STATUS_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
OPERATIONAL Tesis çalışır durumda, şu anda açık olmak zorunda değil.
CLOSED_TEMPORARILY Tesis geçici olarak kapalı.
CLOSED_PERMANENTLY Tesis kalıcı olarak kapalı.

GenerativeSummary

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yerin yapay zeka tarafından üretilmiş özeti.

Alanlar
overview

LocalizedText

Yere genel bakış.

description

LocalizedText

Yerin ayrıntılı açıklaması.

references

References

Özet açıklamasını oluşturmak için kullanılan referanslar.

OpeningHours

Yerin çalışma saati hakkında bilgi.

Alanlar
periods[]

Period

Bu yerin hafta boyunca açık olduğu dönemler. Dönemler, yer-yerel saat diliminde Pazar gününden başlayarak kronolojik olarak sıralanır. Boş (ancak eksik değil) değeri, hiçbir zaman açık olmayan (ör. tadilat nedeniyle geçici olarak kapalı olduğu için) bir yeri belirtir.

weekday_descriptions[]

string

Bu yerin çalışma saatlerini açıklayan yerelleştirilmiş dizeler. Haftanın her günü için bir dize. Çalışma saatleri bilinmiyorsa veya yerelleştirilmiş metne dönüştürülemiyorsa boş olur. Örnek: "Paz: 18:00–06:00"

secondary_hours_type

SecondaryHoursType

İkincil saatlerin türünü tanımlamak için kullanılan bir tür dizesi.

special_days[]

SpecialDay

Döndürülen çalışma saatlerinin kapsadığı döneme denk gelen özel günler için yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir (ör. yılbaşı). Olağanüstü çalışma saatleri varsa current_opening_hours ve current_secondary_opening_hours için ayarlayın.

open_now

bool

Bu yer şu anda açık mı? Bu çalışma saatleri için günün saati veya saat dilimi verileri eksik değilse her zaman mevcuttur.

Dönem

Yerin "open_now" durumunda kaldığı bir dönem.

Alanlar
open

Point

Yerin açılmaya başladığı zaman.

close

Point

Yerin kapanmaya başladığı zaman.

Nokta

Durum değişiyor.

Alanlar
date

Date

Yerin yerel saat dilimindeki tarih.

truncated

bool

Bu uç noktanın kısaltılıp kısaltılmadığı. Kesilme, gerçek çalışma saatleri, aradaki saatleri geri almak istediğimiz zamanların dışında olduğunda ortaya çıkar. Bu nedenle, saatleri söz konusu sınırlara geri keseriz. Bu, isteğin yapıldığı günün gece yarısından en fazla 24 * 7 saat sonra döndürülmesini sağlar.

day

int32

0-6 aralığında bir tam sayı olarak haftanın günü. 0 değeri Pazar, 1, Pazartesi anlamına gelir vb.

hour

int32

2 basamaklı saattir. 00 ile 23 arasında değişir.

minute

int32

2 basamaklı dakikadır. 00 ile 59 arasında değişir.

SecondaryHoursType

İkincil çalışma saatleri türünü tanımlamak için kullanılan bir tür.

Sıralamalar
SECONDARY_HOURS_TYPE_UNSPECIFIED İkincil saat türü belirtilmediğinde varsayılan değer.
DRIVE_THROUGH Bankalar, restoranlar veya eczaneler için arabaya servis saati.
HAPPY_HOUR İndirimli saatler.
DELIVERY Teslimat saati.
TAKEOUT Paket servisi saati.
KITCHEN Mutfak saati.
BREAKFAST Kahvaltı saati.
LUNCH Öğle yemeği saati.
DINNER Akşam yemeği saati.
BRUNCH Brunch saati.
PICKUP Teslim alma saati.
ACCESS Depolama alanlarına erişim saatleri.
SENIOR_HOURS Yaşlılar için özel çalışma saatleri.
ONLINE_SERVICE_HOURS Online hizmet saatleri.

SpecialDay

Döndürülen çalışma saatlerinin kapsadığı döneme denk gelen özel günler için yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir (ör. yılbaşı).

Alanlar
date

Date

Bu özel günün tarihi.

ParkingOptions

Yerin park seçenekleriyle ilgili bilgiler. Bir park yeri aynı anda birden çok seçeneği destekleyebilir.

Alanlar
free_parking_lot

bool

Ücretsiz otopark imkanı vardır.

paid_parking_lot

bool

Ücretli otopark imkanı vardır.

free_street_parking

bool

Cadde üzerinde ücretsiz otopark imkanı vardır.

paid_street_parking

bool

Cadde üzerinde ücretli otopark bulunur.

valet_parking

bool

Vale park hizmeti sunulur.

free_garage_parking

bool

Ücretsiz kapalı otopark bulunur.

paid_garage_parking

bool

Ücretli kapalı otopark bulunur.

PaymentOptions

Yerin kabul ettiği ödeme seçenekleri.

Alanlar
accepts_credit_cards

bool

İşletme, ödeme olarak kredi kartı kabul ediyor.

accepts_debit_cards

bool

Mekan, ödeme olarak banka kartlarını kabul ediyor.

accepts_cash_only

bool

Mekan, ödeme olarak yalnızca nakit kabul ediyor. Bu özelliğe sahip yerler, diğer ödeme yöntemlerini kabul etmeye devam edebilir.

accepts_nfc

bool

Yer, NFC ödemelerini kabul ediyor.

PlusCode

Artı kodu (http://plus.codes), iki biçime sahip bir konum referansıdır: 14mx14m (1/8000'i) veya daha küçük bir dikdörtgeni tanımlayan global kod ve ön eki referans konumuyla değiştiren bileşik kod.

Alanlar
global_code

string

Yerin, 1/8000 x 1/8000 derecelik bir alanı (~14x14 metre) temsil eden, "9FWM33GV+HQ" gibi global (tam) kodu.

compound_code

string

Yerin bileşik kodu. Örneğin, "33GV+HQ, Ramberg, Norveç". Global kodun son ekini içerir ve ön eki, referans varlığın biçimlendirilmiş adıyla değiştirir.

SubDestination

Yerle ilgili alt hedeflerin kaynak adını ve kimliğini girin. Örneğin, farklı terminaller bir havaalanının farklı hedefleridir.

Alanlar
name

string

Alt hedefin kaynak adı.

id

string

Alt hedefin yer kimliği.

PriceLevel

Yerin fiyat düzeyi.

Sıralamalar
PRICE_LEVEL_UNSPECIFIED Yerin fiyat düzeyi belirtilmemiş veya bilinmiyor.
PRICE_LEVEL_FREE Yer ücretsiz hizmet veriyor.
PRICE_LEVEL_INEXPENSIVE Bu mekan pahalı olmayan hizmetler sunuyor.
PRICE_LEVEL_MODERATE Buradaki hizmetler orta ölçekli.
PRICE_LEVEL_EXPENSIVE Pahalı hizmetler sunuyor.
PRICE_LEVEL_VERY_EXPENSIVE Bu mekan çok pahalı hizmetler sunuyor.

Referanslar

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Üretken içeriğin ilgili olduğuna dair referanslar.

Alanlar
reviews[]

Review

Referans işlevi gören yorumlar.

places[]

string

Başvurulan yerlerin kaynak adlarının listesi. Bu ad, Yer kaynağı adlarını kabul eden diğer API'lerde kullanılabilir.

İncele

Bir yer hakkında yapılan yorum hakkında bilgiler.

Alanlar
name

string

Bu yer yorumunu temsil eden ve bu yer yorumunu tekrar aramak için kullanılabilecek bir referans (API "kaynak" adı: places/{place_id}/reviews/{review}).

relative_publish_time_description

string

İnceleme zamanını, geçerli saate göre dil ve ülkeye uygun bir biçimde ifade eden, biçimlendirilmiş son saat dizesi.

text

LocalizedText

Yorumun yerelleştirilmiş metni.

original_text

LocalizedText

Yorum metninin orijinal dili.

rating

double

1,0 ile 5,0 arasında bir sayı; yıldız sayısı da denir.

author_attribution

AuthorAttribution

Bu yorumun yazarı.

publish_time

Timestamp

Yorumun zaman damgası.

SearchNearbyRequest

Yakındaki Arama için protokol isteğinde bulunun.

Alanlar
language_code

string

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 varsa İngilizce tercihi verilebilir.

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

region_code

string

İsteğin geldiğ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 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.

included_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresinden eklenen yer türü (ör. "restoran" veya "gas_station").

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

Çakışan türler varsa (yani bir tür hem dahiled_türlerde hem de hariç tutulan_türlerde 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, bizde {included_types = ["restoran"], excluded_primary_types = ["restoran"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sağlar, ancak esasen "restoran" olarak faaliyet göstermez.

excluded_types[]

string

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

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

Müşteri heminclude_type (ör. restoran) hem de excluded_types (ör. kafe) özelliklerini sağlarsa yanıt, restoran olup kafe olmayan yerleri içermelidir. Yanıt,included_types özelliklerinden en az biriyle eşleşen, excluded_types özelliklerinden hiçbiriyle eşleşen yerleri içermez.

Çakışan türler varsa (yani bir tür hem dahiled_türlerde hem de hariç tutulan_türlerde 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, bizde {included_types = ["restoran"], excluded_primary_types = ["restoran"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sağlar, ancak esasen "restoran" olarak faaliyet göstermez.

included_primary_types[]

string

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

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

Çakışan birincil türler varsa (örneğin, heminclude_primary_types hem de excluded_primary_types içinde bir tür 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, bizde {included_types = ["restoran"], excluded_primary_types = ["restoran"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sağlar, ancak esasen "restoran" olarak faaliyet göstermez.

excluded_primary_types[]

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 (örneğin, heminclude_primary_types hem de excluded_primary_types içinde bir tür 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, bizde {included_types = ["restoran"], excluded_primary_types = ["restoran"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sağlar, ancak esasen "restoran" olarak faaliyet göstermez.

max_result_count

int32

Döndürülecek maksimum sonuç sayısı. Değer, 1 ile 20 (varsayılan) arasında olmalıdır. Bu değer ayarlanmazsa ü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.

location_restriction

LocationRestriction

Zorunlu. Aranacak bölge.

rank_preference

RankPreference

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

LocationRestriction

Aranacak bölge.

Alanlar

Birleştirme alanı type.

type şunlardan yalnızca biri olabilir:

circle

Circle

Merkez noktası ve yarıçapla 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 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.

SearchNearbyResponse

Yakındaki Arama için yanıt protokolü.

Alanlar
places[]

Place

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

SearchTextRequest

SearchText için protokol isteyin.

Alanlar
text_query

string

Zorunlu. Metin araması için metin sorgusu.

language_code

string

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 varsa İngilizce tercihi verilebilir.

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

region_code

string

İsteğin geldiğ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 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.

rank_preference

RankPreference

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

included_type

string

İstenen yer türü. Desteklenen türlerin tam listesi: https://developers.google.com/maps/documentation/places/web-service/place-types. Yalnızca bir dahil edilen türü destekler.

open_now

bool

Aramayı, açık olan yerlerle sınırlandırmak için kullanılır. Varsayılan, false (yanlış) değeridir.

min_rating

double

Ortalama kullanıcı oyu bu sınırın kesinlikle altında olan sonuçları filtreleyerek hariç tutun. Geçerli değer, 0,5'lik bir tempoda 0 ile 5 (her biri dahil) arasında (her iki değer dahil) bir kesirli sayı olmalıdır (yani [0, 0,5, 1,0, ... , 5,0]). Giriş puanı en yakın 0,5'e(tavan) yuvarlanır. Örneğin, 0,6 değerindeki bir derecelendirme 1,0'ın altında olan tüm sonuçları ortadan kaldırır.

max_result_count
(deprecated)

int32

Kullanımdan kaldırıldı: Bunun yerine page_size kullanın.

Sayfa başına döndürülebilecek maksimum sonuç sayısı. Mevcut sonuçların sayısı max_result_count değerinden büyükse sonraki isteklerde bir sonraki sonuç sayfasını almak için page_token işlevine iletilebilecek bir next_page_token döndürülür. 0 sağlanırsa veya herhangi bir değer sağlanmazsa varsayılan olarak 20 kullanılır. Maksimum değer 20'dir. 20'den büyük değerler 20'ye zorlanır. Negatif değerler INVALID_ARGUMENT hatası döndürür.

Hem max_result_count hem de page_size belirtilirse max_result_count yoksayılır.

page_size

int32

İsteğe bağlı. Sayfa başına döndürülebilecek maksimum sonuç sayısı. Mevcut sonuçların sayısı page_size değerinden büyükse sonraki isteklerde bir sonraki sonuç sayfasını almak için page_token işlevine iletilebilecek bir next_page_token döndürülür. 0 sağlanırsa veya herhangi bir değer sağlanmazsa varsayılan olarak 20 kullanılır. Maksimum değer 20'dir; 20'nin üzerindeki değerler 20 olarak ayarlanır. Negatif değerler INVALID_ARGUMENT hatası döndürür.

Hem max_result_count hem de page_size belirtilirse max_result_count yoksayılır.

page_token

string

İsteğe bağlı. Önceki bir TextSearch çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu kodu sağlayın.

Sayfalara ayırırken, TextSearch'e sağlanan page_token, page_size ve max_result_count dışındaki tüm parametreler, sayfa jetonunu sağlayan ilk çağrıyla eşleşmelidir. Aksi takdirde bir INVALID_ARGUMENT hatası döndürülür.

price_levels[]

PriceLevel

Aramayı belirli fiyat seviyeleri olarak işaretlenen yerlerle kısıtlamak için kullanılır. Kullanıcılar herhangi bir fiyat düzeyi kombinasyonunu seçebilir. Varsayılan olarak tüm fiyat düzeylerini seçin.

strict_type_filtering

bool

Include_type için katı tür filtrelemesini ayarlamak amacıyla kullanılır. Doğru değerine ayarlanırsa yalnızca aynı türdeki sonuçlar döndürülür. Varsayılan olarak false değerine ayarlanır.

location_bias

LocationBias

Aranacak bölge. Bu konum bir ön yargı görevi görür ve belirli bir konumun çevresindeki sonuçların döndürülebileceği anlamına gelir. location_restriction ile birlikte ayarlanamaz.

location_restriction

LocationRestriction

Aranacak bölge. Bu konum bir kısıtlama görevi görür. Bu nedenle, belirtilen konumun dışındaki sonuçlar döndürülmez. location_taias ile birlikte ayarlanamaz.

ev_options

EVOptions

İsteğe bağlı. Bir yer arama isteğinin aranabilir EV seçeneklerini ayarlayın.

EVOptions

Bir yer arama isteği için aranabilir EV seçenekleri.

Alanlar
minimum_charging_rate_kw

double

İsteğe bağlı. Kilovat cinsinden gerekli minimum şarj hızı. Şarj oranı belirtilen orandan daha düşük olan yerler filtrelenir.

connector_types[]

EVConnectorType

İsteğe bağlı. Tercih edilen EV konnektörü türlerinin listesi. Listelenen bağlayıcı türlerinden hiçbirini desteklemeyen bir yer filtrelenir.

LocationBias

Aranacak bölge. Bu konum bir ön yargı görevi görür ve belirli bir konumun çevresindeki sonuçların döndürülebileceği anlamına gelir.

Alanlar

Birleştirme alanı type.

type şunlardan yalnızca biri olabilir:

rectangle

Viewport

Kuzeydoğu ve güneybatı köşesiyle tanımlanan dikdörtgen kutu. rectangle.high(), dikdörtgen görüntü alanının kuzeydoğu noktası olmalıdır. rectangle.low(), dikdörtgen görüntü alanının güneybatı noktası olmalıdır. rectangle.low().latitude(), rectangle.high().latitude() değerinden büyük olamaz. Bu, enlem aralığının boş olmasına neden olur. Dikdörtgen görüntü alanı 180 dereceden geniş olamaz.

circle

Circle

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

LocationRestriction

Aranacak bölge. Bu konum bir kısıtlama görevi görür. Bu nedenle, belirtilen konumun dışındaki sonuçlar döndürülmez.

Alanlar

Birleştirme alanı type.

type şunlardan yalnızca biri olabilir:

rectangle

Viewport

Kuzeydoğu ve güneybatı köşesiyle tanımlanan dikdörtgen kutu. rectangle.high(), dikdörtgen görüntü alanının kuzeydoğu noktası olmalıdır. rectangle.low(), dikdörtgen görüntü alanının güneybatı noktası olmalıdır. rectangle.low().latitude(), rectangle.high().latitude() değerinden büyük olamaz. Bu, enlem aralığının boş olmasına neden olur. Dikdörtgen görüntü alanı 180 dereceden geniş olamaz.

RankPreference

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

Sıralamalar
RANK_PREFERENCE_UNSPECIFIED "New York City'deki Restoranlar" gibi kategorik bir sorgu için RELEVANCE varsayılandır. "Mountain View, CA" gibi kategorik olmayan sorgular için rankPreference'u ayarlamadan bırakmanızı öneririz.
DISTANCE Sonuçları mesafeye göre sıralar.
RELEVANCE Sonuçları alaka düzeyine göre sıralar. Sıralama düzeni, normal sıralama yığını tarafından belirlenir.

SearchTextResponse

SearchText için yanıt protokolü.

Alanlar
places[]

Place

Kullanıcının metin arama ölçütlerini karşılayan yerlerin listesi.

contextual_contents[]

ContextualContent

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Her girişin yerler alanında aynı dizindeki karşılık gelen yerle ilişkilendirildiği bağlamsal içeriklerin listesi. İstekteki text_query ile alakalı içerikler tercih edilir. Yerlerden birinde bağlamsal içerik yoksa, bağlamsal olmayan içerik döndürür. Yalnızca içerik bu yerde kullanılamadığında boş bırakılır. İstendiği takdirde bu listede, yer listesindeki kadar giriş bulunmalıdır.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilecek bir jeton. Bu alan atlanır veya boş bırakılırsa sonraki sayfa bulunmaz.