Package google.maps.places.v1

Dizin

Yerler

Places API için hizmet tanımı. Not: Her istek (otomatik tamamlama istekleri hariç) için istek prototipinin dışında ayarlanmış bir alan maskesi gerekir (all/*, varsayılmaz). Alan maskesi, X-Goog-FieldMask HTTP üst bilgisi aracılığıyla ayarlanabilir. https://developers.google.com/maps/documentation/places/web-service/choose-fields adresini ziyaret edin.

AutocompletePlaces

rpc AutocompletePlaces(AutocompletePlacesRequest) returns (AutocompletePlacesResponse)

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

Yetkilendirme kapsamları

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

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

rpc GetPhotoMedia(GetPhotoMediaRequest) returns (PhotoMedia)

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

Yetkilendirme kapsamları

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

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

rpc GetPlace(GetPlaceRequest) returns (Place)

Bir yerin ayrıntılarını, places/{place_id} biçiminde bir dize olan kaynak adına göre alın.

Yetkilendirme kapsamları

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

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

rpc SearchNearby(SearchNearbyRequest) returns (SearchNearbyResponse)

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

Yetkilendirme kapsamları

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

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

rpc SearchText(SearchTextRequest) returns (SearchTextResponse)

Metin sorgusuna dayalı yer arama.

Yetkilendirme kapsamları

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

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

AddressDescriptor

Bir konumun ilişkisel açıklaması. Yakındaki önemli noktalar ve tam kapsayıcı alanlar ile bunların hedef konumla ilişkisini içeren, sıralanmış bir grup içerir.

Alanlar
landmarks[]

Landmark

Yakındaki önemli yerlerin sıralandığı liste. En tanınmış ve en yakın önemli yerler öncelikli olarak sıralanır.

areas[]

Area

İçerdiği veya bitişik olduğu alanların sıralandığı liste. En tanınabilir ve hassas alanlar öncelikli olarak sıralanır.

Bölge

Alan bilgileri ve alanın hedef konumla ilişkisi.

Alanlar, bir konumu tanımlamak için yararlı olan kesin alt mahalle, mahalle ve büyük yerleşim birimlerini içerir.

Alanlar
name

string

Alanın kaynak adı.

place_id

string

Alanın yer kimliği.

display_name

LocalizedText

Alanın görünen adı.

containment

Containment

Hedef konum ile alan arasındaki mekansal ilişkiyi tanımlar.

Kapsama

Hedef konum ile alan arasındaki mekansal ilişkiyi tanımlar.

Sıralamalar
CONTAINMENT_UNSPECIFIED Kapsayıcılık belirtilmedi.
WITHIN Hedef konum, alan bölgesinde ve merkeze yakındır.
OUTSKIRTS Hedef konum, alan bölgesinde, kenara yakın bir yerdedir.
NEAR Hedef konum, alan bölgesinin dışında ancak yakınındadır.

Önemli nokta

Temel yer işareti bilgileri ve yer işaretinin hedef konumla ilişkisi.

Yer işaretleri, bir konumu tanımlamak için kullanılabilecek belirgin yerlerdir.

Alanlar
name

string

Dönüm noktasının kaynak adı.

place_id

string

Simgenin yer kimliği.

display_name

LocalizedText

Dönüm noktasının görünen adı.

types[]

string

Bu yer işareti için bir tür etiket grubu. Olası değerlerin tam listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresine bakın.

spatial_relationship

SpatialRelationship

Hedef konum ile yer işareti arasındaki mekansal ilişkiyi tanımlar.

straight_line_distance_meters

float

Hedefin merkez noktası ile yer işaretinin merkez noktası arasındaki doğrusal mesafe (metre cinsinden). Bazı durumlarda bu değer travel_distance_meters'ten uzun olabilir.

travel_distance_meters

float

Biliniyorsa hedeften yola kadar olan yol ağındaki seyahat mesafesi (metre cinsinden). Bu değer, yaya, araba veya bisiklet gibi ulaşım şeklini hesaba katmaz.

SpatialRelationship

Hedef konum ile yer işareti arasındaki mekansal ilişkiyi tanımlar.

Sıralamalar
NEAR Aşağıda daha ayrıntılı bir ilişki belirtilmemişse varsayılan ilişki budur.
WITHIN Dönüm noktası, bir mekansal geometriye sahiptir ve hedef, bu geometrinin sınırları içindedir.
BESIDE Hedef, işaretin hemen yanındadır.
ACROSS_THE_ROAD Hedef, yolun diğer tarafındaki yer işaretinin tam karşısındadır.
DOWN_THE_ROAD Dönüm noktasıyla aynı rota üzerinde ancak yanında veya karşısında değil.
AROUND_THE_CORNER Dönüm noktasının bulunduğu rota üzerinde değil, ancak bir dönüş uzaklıktadır.
BEHIND Önemli yerin yapısına yakın ancak sokak girişlerinden daha uzak bir yer.

AuthorAttribution

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

Alanlar
display_name

string

Photo veya Review'nin yazarının adı.

uri

string

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

photo_uri

string

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

AutocompletePlacesRequest

AutocompletePlaces için istek prototipi.

Alanlar
input

string

Zorunlu. Aramanın yapılacağı metin dizesi.

location_bias

LocationBias

İsteğe bağlı. Sonuçları belirli bir konuma yönlendirir.

location_bias veya location_restriction'ten en fazla biri ayarlanmalıdır. İkisi de ayarlanmazsa sonuçlar IP adresine göre önyargılı olur. Diğer bir deyişle, IP adresi yanlış bir konumla eşlenir ve önyargılı bir sinyal olarak kullanılır.

location_restriction

LocationRestriction

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

location_bias veya location_restriction'ten en fazla biri ayarlanmalıdır. İkisi de ayarlanmazsa sonuçlar IP adresine göre önyargılı olur. Diğer bir deyişle, IP adresi yanlış bir konumla eşlenir ve önyargılı bir sinyal olarak kullanılır.

included_primary_types[]

string

İsteğe bağlı. Yer Türleri'nde (https://developers.google.com/maps/documentation/places/web-service/place-types) birincil yer türü (ör. "restaurant" veya "gas_station") dahildir veya yalnızca (regions) veya yalnızca (cities). Bir yer yalnızca birincil türü bu listede yer alıyorsa döndürülür. En fazla 5 değer belirtilebilir. 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 eder. Bu bölgeler, en fazla 15 CLDR iki karakterli bölge kodu olarak 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'te kullanılan dil language_code'ten farklıysa veya döndürülen yer için yerel dilden language_code'e çeviri yoksa sonuçlar karma dillerde olabilir.

region_code

string

İsteğe bağlı. CLDR iki karakterli bölge kodu olarak belirtilen bölge kodu. Bu durum, 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 simgesini 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ı. input içindeki imleç konumunu belirten sıfır tabanlı input Unicode karakter ofseti. İmlecin konumu, döndürülen tahminleri etkileyebilir.

Boşsa varsayılan olarak input uzunluğuna 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ıtta yalnızca yer tahminleri döndürülü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, URL ve dosya adı için güvenli bir base64 dizesi olmalıdır. Aksi takdirde INVALID_ARGUMENT hatası döndürülür.

Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve bir yer seçip Yer Ayrıntıları veya Adres Doğrulaması ç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 olabilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Bir oturum sona erdiğinde jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. session_token parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

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

  • Tüm yer otomatik tamamlama çağrıları için oturum jetonları kullanın.
  • Her oturum için yeni bir jeton oluşturun. Sürüm 4 UUID kullanılması ö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 gönderdiğinizden emin olun. Aynı jetonun birden fazla oturumda kullanılması, her isteğin ayrı olarak faturalandırılmasına neden olur.
include_pure_service_area_businesses

bool

İsteğe bağlı. Alan "true" olarak ayarlanmışsa salt hizmet bölgesi işletmelerini dahil edin. Salt hizmet bölgesi işletmesi, müşterileri doğrudan ziyaret eden veya onlara doğrudan hizmet götüren ancak işletme adresinde müşterilere hizmet vermeyen bir işletmedir. Örneğin, temizlik veya tesisatçılık hizmeti sunan işletmeler. Bu işletmelerin Google Haritalar'da fiziksel bir adresi veya konumu yoktur. Yerler, bu işletmeler için location, plus_code ve konumla ilgili diğer alanları döndürmez.

LocationBias

Aranacak bölge. Sonuçlar, belirtilen bölgeye göre taraflı olabilir.

Alanlar

Birlik alanı type.

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

rectangle

Viewport

Kuzeydoğu ve güneybatı köşesi tarafından tanımlanan bir görüntü alanı.

circle

Circle

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

LocationRestriction

Aranacak bölge. Sonuçlar, belirtilen bölgeyle sınırlı olacaktır.

Alanlar

Birlik alanı type.

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

rectangle

Viewport

Kuzeydoğu ve güneybatı köşesi tarafından tanımlanan bir görüntü alanı.

circle

Circle

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

AutocompletePlacesResponse

AutocompletePlaces için yanıt prototipi.

Alanlar
suggestions[]

Suggestion

Alaka düzeyine göre azalan düzende sıralanmış önerilerin listesini içerir.

Öneri

Otomatik tamamlama önerisi sonucu.

Alanlar

Birlik alanı kind.

kind yalnızca aşağıdakilerden biri olabilir:

place_prediction

PlacePrediction

Bir yerle ilgili 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ılabilen veya matches ile biçimlendirilmiş metin.

matches[]

StringRange

Giriş isteğinin text'te eşleştiği yeri tanımlayan dize aralıkları listesi. Aralıklar, text öğesinin belirli bölümlerini biçimlendirmek için kullanılabilir. Eşleşme, dize eşleştirme dışındaki ölçütlere göre belirlendiyse (ör. yazım düzeltmeleri veya transliterasyonlar) alt dize, input ile tam olarak eşleşmeyebilir.

Bu değerler, text için Unicode karakter ofsetleridir. Aralıkların artan ofset değerlerine göre sıralandığı garanti edilir.

PlacePrediction

Bir yer otomatik 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ı tarafından okunabilir adını içerir. Kuruluş sonuçlarında bu genellikle işletmenin adı ve adresidir.

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

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

input ve language_code istekleri farklı dillerdeyse veya yer için yerel dilden language_code'e çeviri yoksa karışık dillerde olabilir.

structured_format

StructuredFormat

Yer tahmininin, yerin adını içeren ana metin ve anlam karışıklığını gideren ek özellikleri (şehir veya bölge gibi) içeren ikincil metin olarak dökümü.

structured_format, iki ayrı ancak birbiriyle alakalı 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 kullanabilir. Bunlar, bir yer tahminini temsil etmenin iki farklı yoludur. Kullanıcılar, structured_format öğesini text olarak ayrıştırmaya veya text öğesini structured_format olarak ayrıştırmaya çalışmamalıdır.

types[]

string

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

Tür, bir yerin kategorisidir. Paylaşılan türlere sahip yerler benzer özelliklere sahiptir.

distance_meters

int32

origin belirtilmişse origin'ten itibaren jeodezik eğrinin metre cinsinden uzunluğu. Rotalar gibi belirli tahminler bu alanı doldurmayabilir.

QueryPrediction

Sorgu otomatik tamamlama tahmini için tahmin sonuçları.

Alanlar
text

FormattableText

Tahmin edilen metin. Bu metin bir yeri değil, bir arama uç noktasında (ör. metin arama) kullanılabilecek bir metin sorgusunu temsil eder.

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

input ve language_code istekleri farklı dillerdeyse veya sorgunun bir kısmının yerel dilden language_code'e çevirisi yoksa karışık dillerde olabilir.

structured_format

StructuredFormat

Sorgu tahmininin, sorguyu içeren ana metin ve anlam karışıklığını gideren ek özellikler (şehir veya bölge gibi) içeren ikincil metin olarak dökümü.

structured_format, iki ayrı ancak birbiriyle alakalı 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 kullanabilir. Bunlar, sorgu tahminini temsil etmenin iki farklı yoludur. Kullanıcılar, structured_format öğesini text olarak ayrıştırmaya veya text öğesini structured_format olarak ayrıştırmaya çalışmamalıdır.

StringRange

Belirli bir metindeki alt dizeyi tanımlar.

Alanlar
start_offset

int32

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

end_offset

int32

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

StructuredFormat

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

Yer tahminlerinde ana metin, yerin adını içerir. Sorgu tahminlerinde ana metin sorguyu içerir.

İkincil metin, yeri daha ayrıntılı olarak tanımlamak veya sorguyu hassaslaştırmak için anlam karışıklığını gideren 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 ayrıntılı olarak tanımlamak veya sorguyu hassaslaştırmak için anlam karışıklığını gideren ek özellikleri (şehir veya bölge gibi) temsil eder.

Daire

Merkezi ve yarıçapı LatLng olan daire.

Alanlar
center

LatLng

Zorunlu. Enlem ve boylamı ortala.

Enlem aralığı [-90,0; 90,0] içinde olmalıdır. Boylam aralığı [-180,0; 180,0] içinde olmalıdır.

radius

double

Zorunlu. Metre cinsinden ölçülen yarıçap. Yarıçap [0,0; 50000,0] aralığında olmalıdır.

ContentBlock

Tek tek yayınlanabilen bir içerik bloğu.

Alanlar
topic

string

İçeriğin konusu (ör. "genel bakış" veya "restoran").

content

LocalizedText

Konuyla ilgili içerikler.

references

References

Deneysel: Daha fazla 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 fazla 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

Yer sorgusuyla alakalı olarak bu yerle ilgili yorumların listesi.

photos[]

Photo

Bu yerin fotoğraflarıyla ilgili, yer sorgusuyla alakalı bilgiler (referanslar dahil).

justifications[]

Justification

Deneysel: Daha fazla 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 fazla 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ıyı neden ilgilendirebileceği sorusuna yanıt verir.

Alanlar

Birlik alanı justification.

justification yalnızca aşağıdakilerden biri olabilir:

review_justification

ReviewJustification

Deneysel: Daha fazla 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 fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

BusinessAvailabilityAttributesJustification

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

Alanlar
takeout

bool

Bir yerin paket servisi olup olmadığını belirtir.

delivery

bool

Bir yerin teslimat hizmeti sunup sunmadığını belirtir.

dine_in

bool

Mekanda yemek servisi yapılıyorsa.

ReviewJustification

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

Kullanıcı yorumu gerekçeleri. Bu, kullanıcı yorumunun son kullanıcıyı ilgilendiren bir bölümünü vurgular. Örneğin, arama sorgusu "odun fırın pizzası" ise yorum gerekçesinde, arama sorgusuyla alakalı metin vurgulanır.

Alanlar
highlighted_text

HighlightedText

review

Review

Vurgulanan metnin oluşturulduğu yorum.

HighlightedText

Gerekçe metniyle vurgulanan metin. Bu, yorumun bir alt kümesidir. Vurgulanacak kelimenin tam olarak hangisi olduğu HighlightedTextRange ile işaretlenir. Metinde vurgulanan birkaç kelime olabilir.

Alanlar
text

string

highlighted_text_ranges[]

HighlightedTextRange

Vurgulanan metnin aralıklarının listesi.

HighlightedTextRange

Vurgulanan metnin aralığı.

Alanlar
start_index

int32

end_index

int32

EVChargeOptions

Yerde barındırılan elektrikli araç şarj istasyonu hakkında bilgi. Terminoloji, https://afdc.energy.gov/fuels/electricity_infrastructure.html adresindeki bilgilere göre belirlenmiştir. Bir bağlantı noktası aynı anda bir aracı şarj edebilir. Bir bağlantı noktasında bir veya daha fazla bağlayıcı bulunur. Bir istasyonda bir veya daha fazla bağlantı noktası bulunur.

Alanlar
connector_count

int32

Bu istasyondaki konnektör sayısı. Ancak bazı bağlantı noktalarında birden fazla bağlayıcı bulunabilir ancak aynı anda yalnızca bir araç şarj edilebilir (ör.). Bu nedenle, bağlayıcı sayısı aynı anda şarj edilebilecek toplam araç sayısından daha fazla olabilir.

connector_aggregation[]

ConnectorAggregation

Aynı tür ve aynı şarj hızına sahip konnektörler içeren elektrikli araç şarj konnektörü toplamalarının listesi.

ConnectorAggregation

[type, max_charge_rate_kw] parametrelerine göre gruplandırılmış elektrikli araç şarj bilgileri. Aynı tür ve maksimum şarj hızına (kW) sahip konnektörlerin elektrikli araç şarjı toplamını gösterir.

Alanlar
type

EVConnectorType

Bu toplama işleminin bağlayıcı türü.

max_charge_rate_kw

double

Toplamadaki her konnektörün sabit maksimum şarj hızı (kW).

count

int32

Bu toplamadaki konnektör 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 toplamadaki şu anda kullanılabilir durumdaki bağlayıcıların sayısı.

out_of_service_count

int32

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

EVConnectorType

Elektrikli araç şarj konnektörü türleriyle ilgili 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 konnektör türleri.
EV_CONNECTOR_TYPE_J1772 J1772 1. tip konnektör.
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 2. tip konnektör. Genellikle MENNEKES olarak adlandırılır.
EV_CONNECTOR_TYPE_CHADEMO CHAdeMO tipi konnektör.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Birleşik Şarj Sistemi (AC ve DC). SAE'ye göre. 1. tip J-1772 konnektörü
EV_CONNECTOR_TYPE_CCS_COMBO_2 Birleşik Şarj Sistemi (AC ve DC). Type-2 Mennekes konnektörüne dayalı
EV_CONNECTOR_TYPE_TESLA Genel TESLA bağlayıcısı. Bu, Kuzey Amerika'da NACS'dir ancak dünyanın diğer bölgelerinde NACS dışında olabilir (ör. CCS Combo 2 (CCS2) veya GB/T). Bu değer, gerçek bir konnektör türünü değil, Tesla markalı bir aracı Tesla'nın sahip olduğu bir şarj istasyonunda şarj etme özelliğini 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ş priz.
EV_CONNECTOR_TYPE_NACS SAE J3400 olarak standartlaştırılmış Kuzey Amerika Şarj Sistemi (NACS).

FuelOptions

Benzin istasyonundaki yakıt seçenekleri hakkında en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir.

Alanlar
fuel_prices[]

FuelPrice

Bu istasyonun sunduğu her yakıt türü için bilinen son yakıt fiyatı. Bu istasyonun sahip olduğu her yakıt türü için bir giriş vardır. Sıralama önemli değildir.

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üncellenme zamanı.

FuelType

Yakıt türleri.

Sıralamalar
FUEL_TYPE_UNSPECIFIED Yakıt türü belirtilmedi.
DIESEL Dizel yakıt.
DIESEL_PLUS Dizel ve yakıt.
REGULAR_UNLEADED Normal kurşunsuz.
MIDGRADE Orta.
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 Sıvılaştırılmış Petrol Gazı.
E80 E 80.
E85 E 85.
E100 E 100.
METHANE Metan.
BIO_DIESEL Biyodizel.
TRUCK_DIESEL Kamyon dizel.

GetPhotoMediaRequest

Fotoğraf kaynağı adı kullanılarak bir yerin fotoğrafının getirilmesi için istek.

Alanlar
name

string

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

Bir yer nesnesinin photos.name alanında döndürülen fotoğrafın kaynak adı, places/{place_id}/photos/{photo_reference} biçimindedir. 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 piksel cinsinden istenilen maksimum genişliğini belirtir. Resim belirtilen değerlerden küçükse orijinal resim döndürülür. Resim herhangi bir boyutta daha büyükse orijinal en boy oranıyla kısıtlanarak iki boyutun daha küçük olanıyla eşleşecek şekilde ölçeklendirilir. Hem max_height_px hem de max_width_px özellikleri, 1 ile 4.800 arasında (ikisi de dahil) bir tam sayı kabul eder. Değer izin verilen aralık içinde değilse INVALID_ARGUMENT hatası döndürülür.

max_height_px veya max_width_px özelliklerinden 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 piksel cinsinden istenilen maksimum yüksekliğini belirtir. Resim belirtilen değerlerden küçükse orijinal resim döndürülür. Resim herhangi bir boyutta daha büyükse orijinal en boy oranıyla kısıtlanarak iki boyutun daha küçük olanıyla eşleşecek şekilde ölçeklendirilir. Hem max_height_px hem de max_width_px özellikleri, 1 ile 4.800 arasında (ikisi de dahil) bir tam sayı kabul eder. Değer izin verilen aralık içinde değilse INVALID_ARGUMENT hatası döndürülür.

max_height_px veya max_width_px özelliklerinden 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ı atlar ve metin biçiminde (ör. HTTP kullanım alanı için JSON biçiminde) bir yanıt oluşturur. Ayarlanmazsa çağrıyı resim medyasına yönlendirmek için bir HTTP yönlendirmesi gönderilir. Bu seçenek, HTTP dışı istekler için yoksayılır.

GetPlaceRequest

Bir yeri, kaynak adına göre getirme isteği. Kaynak adı, places/{place_id} biçiminde bir dizedir.

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österilir.

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

region_code

string

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

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, URL ve dosya adı için güvenli bir base64 dizesi olmalıdır. Aksi takdirde INVALID_ARGUMENT hatası döndürülür.

Oturum, kullanıcı bir sorgu yazmaya başladığında başlar ve bir yer seçip Yer Ayrıntıları veya Adres Doğrulaması ç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 olabilir. Bir oturumdaki her istek için kullanılan kimlik bilgileri aynı Google Cloud Console projesine ait olmalıdır. Bir oturum sona erdiğinde jeton artık geçerli olmaz. Uygulamanız her oturum için yeni bir jeton oluşturmalıdır. session_token parametresi atlanırsa veya bir oturum jetonunu yeniden kullanırsanız oturum, oturum jetonu sağlanmamış gibi ücretlendirilir (her istek ayrı olarak faturalandırılır).

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

  • Tüm yer otomatik tamamlama çağrıları için oturum jetonları kullanın.
  • Her oturum için yeni bir jeton oluşturun. Sürüm 4 UUID kullanılması ö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 gönderdiğinizden emin olun. Aynı jetonun birden fazla oturumda kullanılması, her isteğin ayrı olarak faturalandırılmasına neden olur.

Fotoğraf

Bir yerin fotoğrafıyla ilgili 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ı olarak da bilinir: places/{place_id}/photos/{photo}).

width_px

int32

Kullanılabilen maksimum genişlik (piksel cinsinden).

height_px

int32

Kullanılabilen maksimum yükseklik (piksel cinsinden).

author_attributions[]

AuthorAttribution

Bu fotoğrafın yazarları.

flag_content_uri

string

Kullanıcıların fotoğrafla ilgili bir sorunu işaretleyebileceği bağlantı.

google_maps_uri

string

Fotoğrafı Google Haritalar'da göstermek için bir bağlantı.

PhotoMedia

Places API'den bir fotoğraf medyası.

Alanlar
name

string

Fotoğraf medyasının kaynak adı. places/{place_id}/photos/{photo_reference}/media biçimindedir.

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ı.

display_name

LocalizedText

Yerin yerelleştirilmiş adı. Kullanıcıların okuyabileceği kısa bir açıklama olarak uygundur. Örneğin, "Google Sydney", "Starbucks", "Pyrmont" vb.

types[]

string

Bu sonuç için bir tür etiket grubu. Örneğin, "political" ve "locality". Olası değerlerin tam listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki A ve B tablolarına 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 A ve B tablolarına bakın.

primary_type_display_name

LocalizedText

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

national_phone_number

string

Yerin, ulusal biçimdeki okunabilir telefon numarası.

international_phone_number

string

Yerin, uluslararası standartta, okunabilir telefon numarası.

formatted_address

string

Bu yerin tam ve okunabilir adresi.

short_formatted_address

string

Bu yerin kısa ve okunabilir adresi.

address_components[]

AddressComponent

Her yerleşim birimi düzeyi için tekrarlanan bileşenler. address_components[] dizisiyle ilgili aşağıdaki noktalara dikkat edin: - Adres bileşenleri dizisi, formatted_address dizisinden daha fazla bileşen içerebilir. - Dizi, formatted_address içinde yer alanlardan hariç olmak üzere adres içeren tüm siyasi varlıkları içermeyebilir. Belirli bir adresi içeren tüm siyasi varlıkları almak için adresin enlem/boylamını parametre olarak isteğe göndererek ters coğrafi kodlama özelliğini kullanmanız gerekir. - Yanıtın biçiminin istekler arasında 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, dizindeki konumunu değiştirebilir. Bileşenin türü değişebilir. Belirli bir bileşen, daha sonraki bir yanıtta eksik olabilir.

plus_code

PlusCode

Yer konumunun enlem/boylam artı kodu.

location

LatLng

Bu yerin konumu.

viewport

Viewport

Yeri ortalama boyutlu bir haritada göstermeye uygun bir görüntü alanı. Bu görüntü alanı, işletmenin fiziksel sınırı veya hizmet bölgesi olarak kullanılmamalıdır.

rating

double

Bu yerle ilgili kullanıcı yorumlarına göre 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. bir işletmenin ana sayfası). Bir zincirin parçası olan yerler (ör. IKEA mağazası) için bu, genellikle zincirin tamamının değil, tek bir 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. Bir yer her zaman açıksa (24 saat) close alanının ayarlanmayacağını unutmayın. İstemciler, her zaman açık (24 saat) değerinin 0 değerine sahip [day][Point.day], 0 değerine sahip [hour][Point.hour] ve 0 değerine sahip [minute][Point.minute] içeren bir [open][google.maps.places.v1.Place.OpeningHours.Period.open] dönemi olarak temsil edilebileceğini bilmelidir.

time_zone

TimeZone

IANA Saat Dilimi Veritabanı saat dilimi. Örneğin, "Amerika/New_York".

photos[]

Photo

Bu yerin fotoğraflarıyla ilgili 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 bir veri sağlayıcı grubu.

icon_mask_base_uri

string

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

icon_background_color

string

Onaltılık biçimdeki icon_mask için arka plan rengi (ör. #909CE1).

current_opening_hours

OpeningHours

Önümüzdeki yedi gün (bugün dahil) için çalışma saatleri. Bu süre, isteğin yapıldığı tarihte gece yarısında başlar ve altı gün sonra saat 23:59'da sona erer. Bu alan, özel çalışma saatleri olan tarihler için ayarlanan tüm çalışma saatlerinin special_days alt alanını içerir.

current_secondary_opening_hours[]

OpeningHours

Bir işletmenin ikincil çalışma saatleri hakkında bilgiler de dahil olmak üzere önümüzdeki 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 çalışma saatleri olarak arabalı servis veya teslimat saatlerini belirtebilir. Bu alan, türün alt alanını doldurur. Bu alan, yer türlerine göre önceden tanımlanmış bir çalışma saatleri türü listesinden (ör. DRIVE_THROUGH, PICKUP veya TAKEOUT) yararlanır. Bu alan, özel çalışma saatleri olan tarihler için ayarlanan tüm çalışma saatlerinin special_days alt alanını içerir.

regular_secondary_opening_hours[]

OpeningHours

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

editorial_summary

LocalizedText

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

payment_options

PaymentOptions

Yerin kabul ettiği ödeme seçenekleri. Ödeme seçeneği verileri mevcut değilse ödeme seçeneği alanı ayarlanmamış olur.

parking_options

ParkingOptions

Tesisin sunduğu otopark seçenekleri.

sub_destinations[]

SubDestination

Yerle ilgili alt hedeflerin listesi.

fuel_options

FuelOptions

Benzin istasyonundaki yakıt seçenekleri hakkında en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir.

ev_charge_options

EVChargeOptions

Ev şarj seçenekleri hakkında bilgi.

generative_summary

GenerativeSummary

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

Yerin yapay zeka tarafından oluşturulmuş özeti.

area_summary

AreaSummary

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

Yerin bulunduğu alanın yapay zeka tarafından oluşturulmuş özeti.

containing_places[]

ContainingPlace

Geçerli yerin bulunduğu yerlerin listesi.

address_descriptor

AddressDescriptor

Yerin adres tanımlayıcısı. Adres tanımlayıcıları, bir konumu önemli yerler ve alanlar kullanarak açıklamaya yardımcı olan ek bilgiler içerir. Adres tanımlayıcının bölgesel kapsamını https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage adresinde bulabilirsiniz.

price_range

PriceRange

Bir yerle ilişkili fiyat aralığı.

utc_offset_minutes

int32

Bu yerin saat diliminin şu anda UTC'den sapma süresi. Bu değer, saatin kesirli bir kısmı kadar (ör. X saat ve 15 dakika) kaydırılmış saat dilimlerini desteklemek için dakika cinsinden ifade edilir.

user_rating_count

int32

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

takeout

bool

İşletmenin paket servisi destekleyip desteklemediğini belirtir.

delivery

bool

İşletmenin teslimatı destekleyip desteklemediğini belirtir.

dine_in

bool

İşletmenin kapalı veya açık oturma alanı seçeneklerini destekleyip desteklemediğini belirtir.

curbside_pickup

bool

İşletmenin arabaya teslim alma hizmetini destekleyip desteklemediğini belirtir.

reservable

bool

Yerin rezervasyonu destekleyip desteklemediğini belirtir.

serves_breakfast

bool

Tesiste kahvaltı servisi yapılıp yapılmadığını belirtir.

serves_lunch

bool

Mekanda öğle yemeği servisi yapılıp yapılmadığını belirtir.

serves_dinner

bool

Tesiste akşam yemeği servisi yapılıp yapılmadığını belirtir.

serves_beer

bool

Mekanda bira servisi yapılıp yapılmadığını belirtir.

serves_wine

bool

Mekanda şarap servisi yapılıp yapılmadığını belirtir.

serves_brunch

bool

Geç kahvaltı servisi yapılıp yapılmadığını belirtir.

serves_vegetarian_food

bool

Mekanda vejetaryen yemek servisi olup olmadığını belirtir.

outdoor_seating

bool

Açık havada oturma alanı mevcuttur.

live_music

bool

Canlı müzik hizmeti sunan bir yer.

menu_for_children

bool

Çocuk menüsü var.

serves_cocktails

bool

Burada kokteyl servisi var.

serves_dessert

bool

Tatlı servisi var.

serves_coffee

bool

Kahve servisi var.

good_for_children

bool

Çocuklar için iyi bir yer.

allows_dogs

bool

Tesiste köpek kabul ediliyor.

restroom

bool

Yerde tuvalet var.

good_for_groups

bool

Yer, gruplara uygundur.

good_for_watching_sports

bool

Burası spor etkinliklerini izlemek için uygun bir yer.

accessibility_options

AccessibilityOptions

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

pure_service_area_business

bool

Yerin yalnızca hizmet bölgesi işletmesi olup olmadığını belirtir. Salt hizmet bölgesi işletmesi, müşterileri doğrudan ziyaret eden veya onlara doğrudan hizmet götüren ancak işletme adresinde müşterilere hizmet vermeyen bir işletmedir. Örneğin, temizlik veya tesisatçılık hizmeti sunan işletmeler. Bu işletmelerin Google Haritalar'da fiziksel bir adresi veya konumu olmayabilir.

AccessibilityOptions

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

Alanlar
wheelchair_accessible_parking

bool

Tekerlekli sandalye kullanıcılarına uygun park yeri mevcuttur.

wheelchair_accessible_entrance

bool

Tekerlekli sandalye kullanıcılarına uygun girişi olan yerler.

wheelchair_accessible_restroom

bool

Tesiste tekerlekli sandalye kullanıcılarına uygun tuvalet var.

wheelchair_accessible_seating

bool

Tekerlekli sandalye kullanıcılarına uygun oturma düzeni var.

AddressComponent

Bu bilgiler mevcutsa 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 ülkesine ait bir adres bileşeninin long_name değeri "Avustralya" olabilir.

short_text

string

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

types[]

string

Adres bileşeninin türlerini belirten bir dizi.

language_code

string

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

AreaSummary

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

Yerin bulunduğu alanın yapay zeka tarafından oluşturulmuş özeti.

Alanlar
content_blocks[]

ContentBlock

Alan özetini oluşturan içerik blokları. Her blokta, alanla ilgili ayrı bir konu bulunur.

flag_content_uri

string

Kullanıcıların özetle ilgili bir sorunu işaretleyebileceği bağlantı.

İlişkilendirme

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

Alanlar
provider

string

Yerin veri sağlayıcısının adı.

provider_uri

string

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

BusinessStatus

Yerin işletme durumu.

Sıralamalar
BUSINESS_STATUS_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
OPERATIONAL Tesis faaliyettedir ancak şu anda açık olmayabilir.
CLOSED_TEMPORARILY Tesis geçici olarak kapalı.
CLOSED_PERMANENTLY Tesis kalıcı olarak kapatıldı.

ContainingPlace

Bu yerin bulunduğu yer hakkında bilgi.

Alanlar
name

string

Bu yerin bulunduğu yerin kaynak adı.

id

string

Bu yerin bulunduğu yerin yer kimliği.

GenerativeSummary

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

Yerin yapay zeka tarafından oluşturulmuş özeti.

Alanlar
overview

LocalizedText

Yerle ilgili genel bakış.

overview_flag_content_uri

string

Kullanıcıların, genel bakış özetiyle bir sorunu işaretleyebileceği bağlantı.

description

LocalizedText

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

description_flag_content_uri

string

Kullanıcıların açıklama özetiyle bir sorunu işaretleyebileceği bağlantı.

references

References

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

OpeningHours

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

Alanlar
periods[]

Period

Bu yerin hafta boyunca açık olduğu saatler. Dönemler, yerle ilgili yerel saat diliminde Pazar gününden başlayarak kronolojik sırayla gösterilir. Boş (ancak yok olmayan) bir değer, hiçbir zaman açık olmayan bir yeri (ör. tadilat nedeniyle geçici olarak kapalı) gösterir.

weekday_descriptions[]

string

Bu yerin çalışma saatlerini açıklayan yerelleştirilmiş dizeler (haftanın her günü için birer dize). Çalışma saatleri bilinmiyorsa veya yerelleştirilmiş metne dönüştürülemediyse boş olur. Örnek: "Pzt: 18:00-06:00"

secondary_hours_type

SecondaryHoursType

İkincil saat türlerini 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ünlere ilişkin yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir (ör. Noel günü). İstisnai çalışma saatleri varsa current_opening_hours ve current_secondary_opening_hours için ayarlayın.

next_open_time

Timestamp

Mevcut çalışma saatleri döneminin gelecekte 7 güne kadar olan bir tarihte tekrar başlaması. Bu alan yalnızca istek sunulduğu sırada çalışma saatleri dönemi etkin değilse doldurulur.

next_close_time

Timestamp

Mevcut çalışma saatleri döneminin sona ereceği bir sonraki tarih (7 güne kadar gelecekte). Bu alan yalnızca istek sunulduğu sırada çalışma saatleri dönemi etkinse doldurulur.

open_now

bool

Çalışma saatleri döneminin şu anda etkin olup olmadığı. Normal çalışma saatleri ve mevcut çalışma saatleri için bu alan, yerin açık olup olmadığını belirtir. İkincil çalışma saatleri ve mevcut ikincil çalışma saatleri için bu alan, bu yerin ikincil çalışma saatlerinin etkin olup olmadığını belirtir.

Dönem

Yerin şu anda açık durumunda kaldığı dönem.

Alanlar
open

Point

Yerin açık olmaya başladığı saat.

close

Point

Yerin kapalı olmaya başladığı saat.

Nokta

Durum değiştirme puanları.

Alanlar
date

Date

Yerin yerel saat dilimine göre tarih.

truncated

bool

Bu uç noktanın kısaltılıp kısaltılmadığını belirtir. Gerçek saatler, döndürmek istediğimiz saatler aralığının dışında olduğunda saatler kısaltılır. Bu nedenle, saatler bu sınırlara göre kısaltılır. Bu sayede, istek tarihinden itibaren en fazla 24 * 7 saat içinde yanıt verilebilir.

day

int32

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

hour

int32

24 saat biçiminde saat. 0 ile 23 arasında değişir.

minute

int32

Bir dakika. 0 ile 59 arasında değişir.

SecondaryHoursType

İkincil saat 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 arabayla geçme 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ının çalışma saatleri.
SENIOR_HOURS Yaşlılara ö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ünlere ilişkin yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir (ör. Noel günü).

Alanlar
date

Date

Bu özel günün tarihi.

ParkingOptions

Yerin park yeri seçenekleri hakkında bilgi. Bir otopark aynı anda birden fazla seçeneği destekleyebilir.

Alanlar
free_parking_lot

bool

Tesiste ücretsiz otopark mevcuttur.

paid_parking_lot

bool

Tesiste ücretli otoparklar mevcuttur.

free_street_parking

bool

Tesiste cadde üzerinde ücretsiz park yeri mevcuttur.

paid_street_parking

bool

Tesiste ücretli cadde park yeri mevcuttur.

valet_parking

bool

Tesiste vale park hizmeti sunulur.

free_garage_parking

bool

Tesiste ücretsiz kapalı otopark mevcuttur.

paid_garage_parking

bool

Tesiste ücretli kapalı otopark mevcuttur.

PaymentOptions

Yerin kabul ettiği ödeme seçenekleri.

Alanlar
accepts_credit_cards

bool

Yer, ödeme olarak kredi kartını kabul ediyor.

accepts_debit_cards

bool

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

accepts_cash_only

bool

Yer yalnızca nakit ödeme 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

Plus code (http://plus.codes), iki biçime sahip bir konum referansı: 14 m x 14 m (derecenin 1/8000'i) veya daha küçük bir dikdörtgeni tanımlayan genel kod ve ön eki referans konumla değiştiren birleşik kod.

Alanlar
global_code

string

"9FWM33GV+HQ" gibi yerin küresel (tam) kodu. 1/8000 ile 1/8000 derecelik bir alanı (~14x14 metre) temsil eder.

compound_code

string

Yerin birleşik kodu ("33GV+HQ, Ramberg, Norveç" gibi). Bu kod, genel kodun son ekini içerir ve ön eki, referans öğenin biçimlendirilmiş adıyla değiştirir.

SubDestination

Alt hedefler, ana bir yerle ilişkili belirli yerlerdir. Bu sonuçlar, havaalanı, milli park, üniversite veya stadyum gibi büyük veya karmaşık bir yer arayan kullanıcılara daha spesifik hedefler sunar. Örneğin, bir havalimanındaki alt hedefler, ilişkili terminalleri ve otoparkları içerebilir. Alt hedefler, yer kimliğini ve yer kaynağı adını döndürür. Bu bilgiler, alt hedefin görünen adı ve konumu da dahil olmak üzere daha zengin ayrıntılar almak için sonraki Yer Ayrıntıları (Yeni) isteklerinde kullanılabilir.

Alanlar
name

string

Alt hedefin kaynak adı.

id

string

Alt varış noktasının yer kimliği.

Çoklu çizgi

Bir rota çoklu çizgisi. Yalnızca dize olarak iletilebilen ve minimum kayıplı sıkıştırma içeren kodlanmış bir çok çizgiyi destekler. Bu, Routes API'nin varsayılan çıkışıdır.

Alanlar
Birlik alanı polyline_type. Çoklu çizginin türünü kapsar. Rotalar API çıkışı varsayılan olarak encoded_polyline değerine ayarlanır. polyline_type yalnızca aşağıdakilerden biri olabilir:
encoded_polyline

string

Routes API tarafından varsayılan olarak döndürülen kodlanmış bir çok çizgi. Kodlayıcı ve kod çözücü araçlarını inceleyin.

PriceLevel

Yerin fiyat düzeyi.

Sıralamalar
PRICE_LEVEL_UNSPECIFIED Yer fiyat düzeyi belirtilmemiş veya bilinmiyor.
PRICE_LEVEL_FREE Tesis ücretsiz hizmetler sunuyor.
PRICE_LEVEL_INEXPENSIVE Uygun fiyatlı hizmetler sunuluyor.
PRICE_LEVEL_MODERATE Orta düzeyde fiyatlı hizmetler sunuluyor.
PRICE_LEVEL_EXPENSIVE Burası pahalı hizmetler sunuyor.
PRICE_LEVEL_VERY_EXPENSIVE Burası çok pahalı hizmetler sunuyor.

PriceRange

Bir yerle ilişkili fiyat aralığı. end_price ayarlanmamış olabilir.Bu, üst sınırı olmayan bir aralığı gösterir (ör. "100 TL'den fazla").

Alanlar
start_price

Money

Fiyat aralığının alt sınırı (dahil). Fiyat bu tutarda veya bu tutardan yüksek olmalıdır.

end_price

Money

Fiyat aralığının üst sınırı (hariç). Fiyat bu tutardan düşük olmalıdır.

Referanslar

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

Üretken içeriğin ilişkili olduğu referans.

Alanlar
reviews[]

Review

Referans olarak kullanılabilecek yorumlar.

places[]

string

Referans verilen yerlerin kaynak adlarının listesi. Bu ad, yer kaynak adlarını kabul eden diğer API'lerde kullanılabilir.

İncele

Bir yerle ilgili 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ı olarak da bilinir: places/{place_id}/reviews/{review}).

relative_publish_time_description

string

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

text

LocalizedText

Yorumun yerelleştirilmiş metni.

original_text

LocalizedText

Orijinal dilinde yorum metni.

rating

double

1,0 ile 5,0 arasında bir sayı. Yıldız sayısı olarak da bilinir.

author_attribution

AuthorAttribution

Bu yorumun yazarı.

publish_time

Timestamp

İncelemenin zaman damgası.

flag_content_uri

string

Kullanıcıların yorumla ilgili bir sorunu işaretleyebileceği bağlantı.

google_maps_uri

string

Yorumu Google Haritalar'da göstermek için bir bağlantı.

RouteModifiers

Rotalar hesaplanırken karşılanması gereken bir dizi isteğe bağlı koşulu kapsar.

Alanlar
avoid_tolls

bool

İsteğe bağlı. Doğru olarak ayarlandığında, makul olduğunda ücretli yollardan kaçınarak ücretli yol içermeyen rotalara öncelik verir. Yalnızca DRIVE ve TWO_WHEELER TravelMode için geçerlidir.

avoid_highways

bool

İsteğe bağlı. Doğru olarak ayarlandığında, makul olduğunda otoyolları kullanmaz ve otoyol içermeyen rotalara öncelik verir. Yalnızca DRIVE ve TWO_WHEELER TravelMode için geçerlidir.

avoid_ferries

bool

İsteğe bağlı. Doğru olarak ayarlandığında, makul olduğunda feribotları atlar ve feribot içermeyen rotalara öncelik verir. Yalnızca DRIVE ve TWO_WHEELER TravelMode için geçerlidir.

avoid_indoor

bool

İsteğe bağlı. Doğru olarak ayarlandığında, makul olduğunda kapalı alanda gezinmeyi önler ve kapalı alan gezinmesi içermeyen rotalara öncelik verir. Yalnızca WALK TravelMode için geçerlidir.

RoutingParameters

Hem bir rota boyunca (sonuç sıralamasının etkileneceği) hem de sonuçlardaki seyahat sürelerini hesaplamak için yanıttaki yerlere yönelik rota hesaplamalarını yapılandırmak üzere kullanılan parametreler.

Alanlar
origin

LatLng

İsteğe bağlı. Poli çizgisinde tanımlanan kaynağı geçersiz kılan açık bir yönlendirme kaynağı. Varsayılan olarak çoklu çizginin orijini kullanılır.

travel_mode

TravelMode

İsteğe bağlı. Ulaşım şekli.

route_modifiers

RouteModifiers

İsteğe bağlı. Rota değiştiriciler.

routing_preference

RoutingPreference

İsteğe bağlı. Yönlendirme özetlerinin nasıl hesaplanacağını belirtir. Sunucu, rotayı hesaplamak için seçilen yönlendirme tercihini kullanmaya çalışır. Trafik bilinçli yönlendirme tercihi yalnızca DRIVE veya TWO_WHEELER travelMode için kullanılabilir.

RoutingPreference

Rota hesaplanırken dikkate alınacak faktörleri belirten bir değer kümesi.

Sıralamalar
ROUTING_PREFERENCE_UNSPECIFIED Yönlendirme tercihi belirtilmedi. Varsayılan olarak TRAFFIC_UNAWARE değerine ayarlanır.
TRAFFIC_UNAWARE Rotaları, canlı trafik koşullarını dikkate almadan hesaplar. Trafik koşulları önemli olmadığında veya geçerli olmadığında uygundur. Bu değer kullanıldığında en düşük gecikme süresi elde edilir. Not: TravelMode, DRIVE ve TWO_WHEELER için seçilen rota ve süre, mevcut yol koşullarına değil, yol ağına ve zamana bağlı olmayan ortalama trafik koşullarına göre belirlenir. Bu nedenle, rotalar geçici olarak kapalı olan yollar içerebilir. Belirli bir istek için sonuçlar, yol ağındaki değişiklikler, güncellenen ortalama trafik koşulları ve hizmetin dağıtılmış yapısı nedeniyle zaman içinde değişiklik gösterebilir. Sonuçlar, herhangi bir zamanda veya sıklıkta neredeyse eşdeğer rotalar arasında da değişiklik gösterebilir.
TRAFFIC_AWARE Rotaları, gerçek zamanlı trafik koşullarını dikkate alarak hesaplar. TRAFFIC_AWARE_OPTIMAL'e kıyasla, gecikmeyi önemli ölçüde azaltmak için bazı optimizasyonlar uygulanır.
TRAFFIC_AWARE_OPTIMAL Çoğu performans optimizasyonu uygulanmadan, canlı trafik koşullarını dikkate alarak rotaları hesaplar. Bu değerin kullanılması en yüksek gecikmeyi oluşturur.

RoutingSummary

Yönlendirmenin başlangıç noktasından yanıttaki bir yere kadar olan süre ve mesafe ve istenen durumlarda bu yerden hedefe kadar olan ikinci bir aşama. Not: İsteğe routingParameters.origin veya searchAlongRouteParameters.polyline.encodedPolyline parametresini eklemeden alan maskesine routingSummaries eklemek hataya neden olur.

Alanlar
legs[]

Leg

Seyahatin bölümleri.

Belirli bir başlangıç noktasından seyahat süresini ve mesafesini hesapladığınızda legs, başlangıç noktasından hedefe kadar olan süreyi ve mesafeyi içeren tek bir bacağı içerir. Rota boyunca arama yaptığınızda legs iki bölüm içerir: biri başlangıç noktasından yere, diğeri yerden hedefe.

directions_uri

string

Belirtilen rota özetindeki yol noktalarını kullanarak Google Haritalar'da yol tarifini gösteren bir bağlantı. Bu bağlantı tarafından oluşturulan rotanın, yönlendirme özetini oluşturmak için kullanılan rotayla aynı olacağı garanti edilmez. Bağlantı, yol tarifi bağlantısını oluşturmak için istekte sağlanan bilgileri (geçerli olduğunda routingParameters ve searchAlongRouteParameters alanları dahil) kullanır.

Bacak

Bir seyahat, bir yerden başka bir yere yapılan yolculuğun tek bir bölümüdür.

Alanlar
duration

Duration

Yolculuğun bu bölümünün tamamlanması için gereken süre.

distance_meters

int32

Seyahatin bu kısmının mesafesi.

SearchNearbyRequest

Yakındakileri Ara prototipini isteyin.

Alanlar
language_code

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.

region_code

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.

included_types[]

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 included_types hem de excluded_types 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, {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sunar ancak öncelikle "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. "restaurant" veya "gas_station").

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

Müşteri hem included_types (ör. restoran) hem de excluded_types (ör. kafe) sağlarsa yanıtta restoran olan ancak kafe olmayan yerler yer almalıdır. Yanıt, included_types parametresinden en az biriyle eşleşen ve excluded_types parametresinden hiçbiriyle eşleşmeyen yerleri içerir.

Çakışan tür varsa (ör. bir tür hem included_types hem de excluded_types 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, {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sunar ancak öncelikle "restoran" olarak faaliyet göstermez.

included_primary_types[]

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 included_primary_types hem de excluded_primary_types 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, {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sunar ancak öncelikle "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. "restaurant" veya "gas_station").

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

Çakışan birincil türler varsa (ör. bir tür hem included_primary_types hem de excluded_primary_types 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, {included_types = ["restaurant"], excluded_primary_types = ["restaurant"]} varsa döndürülen yerler "restoran" ile ilgili hizmetler sunar ancak öncelikle "restoran" olarak faaliyet göstermez.

max_result_count

int32

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.

location_restriction

LocationRestriction

Zorunlu. Aranacak bölge.

rank_preference

RankPreference

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

routing_parameters

RoutingParameters

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

LocationRestriction

Aranacak bölge.

Alanlar

Birlik alanı type.

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

circle

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.

SearchNearbyResponse

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

Alanlar
places[]

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.

routing_summaries[]

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.

SearchTextRequest

SearchText için proto isteyin.

Alanlar
text_query

string

Zorunlu. Metin arama için metin sorgusu.

language_code

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.

region_code

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.

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 desteklenir.

open_now

bool

Aramayı şu anda açık olan yerlerle kısıtlamak için kullanılır. Varsayılan değer yanlıştır.

min_rating

double

Ortalama kullanıcı puanı bu sınırın altında olan sonuçları filtreleyin. Geçerli değer, 0,5 ritimde 0 ile 5 arasında (bu değerler dahil) bir kayan nokta olmalıdır. Yani [0, 0,5, 1,0, ... , 5,0] dahil. Giriş derecelendirmesi en yakın 0,5'e(tavan) yuvarlanır. Örneğin, 0,6 puan, 1,0'dan düşük puana sahip tüm sonuçları ortadan kaldırır.

max_result_count
(deprecated)

int32

Desteği sonlandırıldı: Bunun yerine page_size politikasını kullanın.

Sayfa başına döndürülebilecek maksimum sonuç sayısı. Mevcut sonuç sayısı max_result_count'ten büyükse sonraki isteklerde sonuçların bir sonraki sayfasını almak için page_token'ye iletilebilecek bir next_page_token döndürülür. 0 veya herhangi bir değer sağlanmazsa varsayılan olarak 20 kullanılır. Maksimum değer 20'dir. 20'den yüksek değerler 20'ye zorlanacaktı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ç sayısı page_size'ten büyükse sonraki isteklerde sonuçların bir sonraki sayfasını almak için page_token'ye iletilebilecek bir next_page_token döndürülür. 0 veya herhangi bir değer sağlanmazsa varsayılan olarak 20 kullanılır. Maksimum değer 20'dir. 20'den yüksek 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 bunu sağlayın.

Sayfa ayırma işleminde, 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 INVALID_ARGUMENT hatası döndürülür.

price_levels[]

PriceLevel

Aramayı belirli fiyat seviyeleri olarak işaretlenmiş yerlerle sınırlamak için kullanılır. Kullanıcılar istedikleri fiyat seviyesi kombinasyonlarını seçebilir. Varsayılan olarak tüm fiyat seviyeleri seçilidir.

strict_type_filtering

bool

included_type için katı tür filtrelemeyi ayarlamak için kullanılır. Doğru değerine ayarlanırsa yalnızca aynı türde sonuçlar döndürülür. Varsayılan değer yanlıştır.

location_bias

LocationBias

Aranacak bölge. Bu konum, belirli bir konumun çevresindeki sonuçların döndürülmesi anlamına gelen bir önyargı görevi görür. location_restriction ile birlikte ayarlanamaz.

location_restriction

LocationRestriction

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

ev_options

EVOptions

İsteğe bağlı. Bir yer arama isteğinin aranabilir elektrikli araç seçeneklerini ayarlama

routing_parameters

RoutingParameters

İsteğe bağlı. Sonuçlara yönlendirme için ek parametreler.

search_along_route_parameters

SearchAlongRouteParameters

İsteğe bağlı. Bir rota üzerinde arama yapmak için ek parametreler prototipi.

include_pure_service_area_businesses

bool

İsteğe bağlı. Alan "true" olarak ayarlanmışsa salt hizmet bölgesi işletmelerini dahil edin. Salt hizmet bölgesi işletmesi, müşterileri doğrudan ziyaret eden veya onlara doğrudan hizmet götüren ancak işletme adresinde müşterilere hizmet vermeyen bir işletmedir. Örneğin, temizlik veya tesisatçılık hizmeti sunan işletmeler. Bu işletmelerin Google Haritalar'da fiziksel bir adresi veya konumu yoktur. Yerler, bu işletmeler için location, plus_code ve konumla ilgili diğer alanları döndürmez.

EVOptions

Bir yer arama isteğinin aranabilir elektrikli araç seçenekleri.

Alanlar
minimum_charging_rate_kw

double

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

connector_types[]

EVConnectorType

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

LocationBias

Aranacak bölge. Bu konum, belirli bir konumun çevresindeki sonuçların döndürülmesi anlamına gelen bir önyargı görevi görür.

Alanlar

Birlik alanı type.

type yalnızca aşağıdakilerden 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 işlem, boş bir enlem aralığına neden olur. Dikdörtgen görüntü alanı 180 dereceden geniş olamaz.

circle

Circle

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

LocationRestriction

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

Alanlar

Birlik alanı type.

type yalnızca aşağıdakilerden 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 işlem, boş bir enlem aralığı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'taki restoranlar" gibi kategorik bir sorgu için varsayılan değer RELEVANCE'tır. "Mountain View, CA" gibi kategorik olmayan sorgular için rankPreference değerini ayarlamamanı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 grubuna göre belirlenir.

SearchAlongRouteParameters

Araması yapılacak rotayı tanımlayan, Routes API'den önceden hesaplanmış bir çok çizgiyi belirtir. Bir rota boyunca arama yapmak, arama sonuçlarını etkilemek için locationBias veya locationRestriction istek seçeneğini kullanmaya benzer. Ancak locationBias ve locationRestriction seçenekleri, arama sonuçlarını belirli bir bölgeye göre yönlendirmenize olanak tanır. Bu seçenek ise sonuçları bir seyahat rotası boyunca yönlendirmenize olanak tanır.

Sonuçların, belirtilen rota üzerinde olması garanti edilmez. Sonuçlar, çoklu çizgi tarafından tanımlanan arama alanında ve isteğe bağlı olarak da başlangıçtan hedefe olan minimum ek yol sürelerine göre locationBias veya locationRestriction tarafından sıralanır. Sonuçlar, özellikle sağlanan çoklu çizgi başlangıçtan hedefe giden en uygun rotayı tanımlamıyorsa alternatif bir rota üzerinde olabilir.

Alanlar
polyline

Polyline

Zorunlu. Rota çoklu çizgisi.

SearchTextResponse

SearchText için yanıt protosu.

Alanlar
places[]

Place

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

routing_summaries[]

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, isterseniz yer listesi kadar giriş olabilir.

contextual_contents[]

ContextualContent

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

Her girişin, yerler alanındaki aynı dizindeki ilgili yerle ilişkilendirildiği bağlamsal içeriklerin listesi. İstekteki text_query ile alakalı içerikler tercih edilir. Bağlamsal içerik, yerlerden biri için kullanılamıyorsa bağlama uygun olmayan içerik döndürülür. Bu alan yalnızca içerik bu yerde kullanılamadığında boş olur. Bu listede, isterseniz yer listesi kadar giriş olabilir.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa veya boşsa sonraki sayfa yoktur.

search_uri

string

Bağlantı, kullanıcının Google Haritalar'da isteğinde belirtilen metin sorgusuyla arama yapmasına olanak tanır.

TravelMode

Seyahat şekli seçenekleri. Bu seçenekler, Routes API'nin sunduğu seçeneklerle eşlenir.

Sıralamalar
TRAVEL_MODE_UNSPECIFIED Ulaşım şekli belirtilmedi. Varsayılan olarak DRIVE değerine ayarlanır.
DRIVE Binek araçla seyahat edin.
BICYCLE Bisikletle seyahat edin. search_along_route_parameters ile desteklenmez.
WALK Yürüyerek seyahat edin. search_along_route_parameters ile desteklenmez.
TWO_WHEELER Scooter ve motosiklet gibi her türlü motorlu iki tekerlekli araçlar. Bunun, insan gücüyle çalışan ulaşım araçlarını kapsayan BICYCLE ulaşım modundan farklı olduğunu unutmayın. search_along_route_parameters ile desteklenmez. Yalnızca İki tekerlekli araçlar için desteklenen ülkeler ve bölgeler bölümünde listelenen ülkelerde desteklenir.