Package google.maps.places.v1

Dizin

Yerler

Places API'nin hizmet tanımı. Not: Her istek (Autocomplete ve GetPhotoMedia istekleri hariç) için istek proto'nun dışında bir alan maskesi ayarlanması gerekir (all/*, varsayılmaz). Alan maskesi, HTTP üstbilgisi X-Goog-FieldMask 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)

Belirtilen giriş için tahminler 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çimindeki 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 arama

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ın sıralanmış bir kümesini, kesin sınırları olan alanları ve bunların hedef konumla ilişkisini içerir.

Alanlar
landmarks[]

Landmark

Yakındaki önemli noktaların sıralı listesi. En çok tanınan ve en yakındaki önemli noktalar ilk sırada yer alır.

areas[]

Area

İçeren veya bitişik alanların sıralı listesi. En tanınabilir ve hassas alanlar ilk sırada yer alır.

Bölge

Bölge bilgileri ve bölgenin hedef konumla ilişkisi.

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

Alanlar
name

string

Alan kaynağının adı.

place_id

string

Bölgenin yer kimliği.

display_name

LocalizedText

Bölgenin 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 Kapsama belirtilmemiş.
WITHIN Hedef konum, alan bölgesinin içinde ve merkeze yakındır.
OUTSKIRTS Hedef konum, alan bölgesinin içinde ve kenara yakındır.
NEAR Hedef konum, bölge alanının dışında ancak yakında.

Önemli nokta

Temel simge yapı bilgileri ve simge yapının hedef konumla ilişkisi.

Önemli noktalar, bir konumu tanımlamak için kullanılabilecek belirgin yerlerdir.

Alanlar
name

string

Önemli yerin kaynak adı.

place_id

string

Önemli yerin yer kimliği.

display_name

LocalizedText

Önemli yerin görünen adı.

types[]

string

Bu önemli nokta için bir dizi tür etiketi. 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 önemli nokta arasındaki mekansal ilişkiyi tanımlar.

straight_line_distance_meters

float

Hedefin merkez noktası ile yer işaretinin merkez noktası arasındaki düz çizgi mesafesi (metre cinsinden). Bazı durumlarda bu değer travel_distance_meters değerinden uzun olabilir.

travel_distance_meters

float

Hedef ile simge yapı arasındaki yol ağında bilinen seyahat mesafesi (metre cinsinden). Bu değerde yürüme, araba kullanma veya bisiklet sürme gibi ulaşım şekilleri dikkate alınmaz.

SpatialRelationship

Hedef konum ile önemli nokta arasındaki mekansal ilişkiyi tanımlar.

Sıralamalar
NEAR Aşağıda daha spesifik bir durum söz konusu değilse varsayılan ilişki budur.
WITHIN Önemli noktanın uzamsal geometrisi var ve hedef, bu geometrinin sınırları içinde.
BESIDE Hedef, doğrudan yer işaretinin bitişiğindedir.
ACROSS_THE_ROAD Hedef, yolun diğer tarafındaki yer işaretinin tam karşısında.
DOWN_THE_ROAD Yer işaretiyle aynı rota üzerinde ancak yanında veya karşısında değil.
AROUND_THE_CORNER Önemli yerle aynı rota üzerinde değil ancak tek bir dönüş uzaklığında.
BEHIND Önemli yapının bulunduğu yere yakın ancak cadde girişlerinden daha uzakta.

AuthorAttribution

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

Alanlar
display_name

string

Photo veya Review yazarının adı.

uri

string

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

photo_uri

string

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

AutocompletePlacesRequest

AutocompletePlaces için istek proto'su.

Alanlar
input

string

Zorunlu. Arama yapılacak metin dizesi.

location_bias

LocationBias

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

En fazla bir location_bias veya location_restriction ayarlanmalıdır. İkisi de ayarlanmamışsa sonuçlar IP adresine göre yanlı olur. Yani IP adresi, kesin olmayan bir konumla eşlenir ve yanlılık sinyali olarak kullanılır.

location_restriction

LocationRestriction

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

En fazla bir location_bias veya location_restriction ayarlanmalıdır. İkisi de ayarlanmamışsa sonuçlar IP adresine göre yanlı olur. Yani IP adresi, kesin olmayan bir konumla eşlenir ve yanlılık sinyali 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) yer alan birincil yer türü (ör. "restaurant" veya "gas_station"), 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 edin. En fazla 15 CLDR iki karakterli bölge kodu belirtilebilir. 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 yer alır.

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 içinde kullanılan dil language_code dilinden farklıysa veya döndürülen yerin yerel dilden language_code diline çevirisi yoksa sonuçlar farklı 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. Ayrıca, hangi sonuçların döndürüleceğini de etkileyebilir. Bu işlem, sonuçları belirtilen bölgeyle kısıtlamaz. Sonuçları bir bölgeyle sınırlamak 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 gösteren, sıfır tabanlı bir Unicode karakteri uzaklığıdır.input İmleç konumu, hangi tahminlerin döndürüleceğini etkileyebilir.

Boşsa varsayılan olarak input uzunluğuna ayarlanır.

include_query_predictions

bool

İsteğe bağlı. Doğruysa yanıtta hem yer hem de sorgu tahminleri yer alır. 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ının sorgu yazmaya başlamasıyla başlar, bir yer seçmesi ve Yer Ayrıntıları veya Adres Doğrulama'ya yönelik bir çağrı yapılmasıyla sona erer. Her oturumda birden fazla sorgu olabilir ve bunları bir Yer Ayrıntıları veya Adres Doğrulama isteği takip edebilir. 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 geçerliliğini kaybeder. 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ı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.
include_pure_service_area_businesses

bool

İsteğe bağlı. Alan doğru 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 teslimat yapan ancak işletme adresinde müşterilere hizmet vermeyen işletmelerdir. Örneğin, temizlik veya tesisatçılık hizmeti sunan işletmeler. Bu işletmelerin Google Haritalar'da fiziksel adresi veya konumu yoktur. Places, 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

type birleşik alanı.

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

rectangle

Viewport

Kuzeydoğu ve güneybatı köşesiyle tanımlanan bir görünüm alanı.

circle

Circle

Bir merkez noktası ve yarıçap ile tanımlanan daire.

LocationRestriction

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

Alanlar

type birleşik alanı.

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

rectangle

Viewport

Kuzeydoğu ve güneybatı köşesiyle tanımlanan bir görünüm alanı.

circle

Circle

Bir merkez noktası ve yarıçap ile tanımlanan daire.

AutocompletePlacesResponse

AutocompletePlaces için yanıt proto'su.

Alanlar
suggestions[]

Suggestion

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

Öneri

Otomatik tamamlama önerisi sonucu.

Alanlar

kind birleşik alanı.

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

place_prediction

PlacePrediction

Bir yer için tahmin.

query_prediction

QueryPrediction

Bir sorgu için tahmin.

FormattableText

Yer veya sorgu tahminini temsil eden metin. Metin olduğu gibi kullanılabilir veya biçimlendirilebilir.

Alanlar
text

string

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

matches[]

StringRange

Giriş isteğinin text içinde nerede eşleştiğini tanımlayan dize aralıklarının listesi. Aralıklar, text belirli bölümlerini biçimlendirmek için kullanılabilir. Eşleşme, dize eşleşmesi dışındaki ölçütlere (ör. yazım düzeltmeleri veya çeviri yazılar) göre belirlendiyse alt dizeler input ile tam olarak eşleşmeyebilir.

Bu değerler, text Unicode karakter ofsetleridir. Aralıkların, artan uzaklık değerlerine göre sıralanacağı garanti edilir.

PlacePrediction

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 okunabilir adını içerir. Kuruluş sonuçlarında 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 ilişkili kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler bunun yerine structured_format kullanabilir. Bunlar, bir Yer tahminini göstermenin iki farklı yoludur. Kullanıcılar, structured_format öğesini text olarak veya tam tersi şekilde ayrıştırmaya çalışmamalıdır.

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

İstek input ve language_code farklı dillerdeyse veya yerin yerel dilden language_code diline çevirisi yoksa karma dillerde olabilir.

structured_format

StructuredFormat

Yer tahmininin, yer adını içeren ana metin ve ek ayırt edici özellikler (ör. şehir veya bölge) içeren ikincil metin olarak ayrılması.

structured_format, iki ayrı ancak ilişkili 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 kullanmak isteyebilir. Bunlar, bir Yer tahminini göstermenin iki farklı yoludur. Kullanıcılar, structured_format öğesini text olarak 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 A veya B tablosunda bu Yer için geçerli olan türlerin listesi.

Tür, bir yerin sınıflandırılmasıdır. Paylaşılan türlere sahip yerler benzer özelliklere sahip olur.

distance_meters

int32

origin belirtilmişse origin konumundan itibaren jeodezik uzunluğu metre cinsinden. Rotalar gibi bazı 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, 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 ilişkili kullanıcı arayüzü öğesi göstermek isteyen geliştiriciler bunun yerine structured_format kullanabilir. Bunlar, sorgu tahminini göstermenin iki farklı yoludur. Kullanıcılar, structured_format öğesini text olarak veya tam tersi şekilde ayrıştırmaya çalışmamalıdır.

İstek input ve language_code farklı dillerdeyse veya sorgunun bir bölümü yerel dilden language_code diline çevrilmemişse yanıt karma dillerde olabilir.

structured_format

StructuredFormat

Sorgu tahmininin, sorguyu içeren ana metin ve ek netleştirici özellikler (ör. şehir veya bölge) içeren ikincil metin olarak ayrılması.

structured_format, iki ayrı ancak ilişkili 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 kullanmak isteyebilir. Bunlar, sorgu tahminini göstermenin iki farklı yoludur. Kullanıcılar, structured_format öğesini text olarak veya tam tersi şekilde 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ı uzaklığı (dahil).

end_offset

int32

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

StructuredFormat

Bir yerin veya sorgu tahmininin ana metin ve ikincil metin olarak ayrılmış halini içerir.

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

İkincil metin, yeri daha iyi tanımlamak veya sorguyu daha iyi hale getirmek için ek ayırt edici özellikler (ör. şehir veya bölge) içerir.

Alanlar
main_text

FormattableText

Yerin veya sorgunun adını gösterir.

secondary_text

FormattableText

Yeri daha iyi tanımlamak veya sorguyu daha ayrıntılı hale getirmek için ek netleştirici özellikleri (ör. şehir veya bölge) temsil eder.

Daire

Merkezi ve yarıçapı LatLng olan daire.

Alanlar
center

LatLng

Zorunlu. Merkez enlemi ve boylamı.

Enlem aralığı [-90.0, 90.0] arasında olmalıdır. Boylam aralığı [-180.0, 180.0] içinde olmalıdır.

radius

double

Zorunlu. Yarıçap metre cinsinden ölçülür. Yarıçap [0.0, 50000.0] aralığında olmalıdır.

ContentBlock

Ayrı ayrı yayınlanabilen bir içerik bloğu.

Alanlar
content

LocalizedText

Konuyla ilgili içerik.

referenced_places[]

string

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

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çerikler.

Alanlar
reviews[]

Review

Bu yerle ilgili yorumların listesi (yer sorgusuyla alakalı)

photos[]

Photo

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

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 neden bir son kullanıcının ilgisini çekebileceği sorusunu yanıtlar.

Alanlar

justification birleşik alanı.

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, bir işletmenin sahip olduğu ve son kullanıcının ilgisini çekebilecek bazı özellikleri gösterir.

Alanlar
takeout

bool

Bir yerde paket servis hizmeti sunulup sunulmadığı

delivery

bool

Bir yerin teslimat hizmeti sunup sunmadığı

dine_in

bool

Mekanın, müşterilerin içeride yemek yemesine izin verip vermediği

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 özellik, kullanıcı yorumunun son kullanıcının ilgisini çekecek bir bölümünü vurgular. Örneğin, arama sorgusu "odun fırınında pizza" 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 tarafından vurgulanan metin. Bu, yorumun kendisinin bir alt kümesidir. Vurgulanacak kelime, HighlightedTextRange ile işaretlenir. Vurgulanan metinde birden fazla kelime olabilir.

Alanlar
text

string

highlighted_text_ranges[]

HighlightedTextRange

Vurgulanan metin 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 bilgiler. Terminoloji, https://afdc.energy.gov/fuels/electricity_infrastructure.html adresinde belirtilen şekilde kullanılmaktadır. Bir bağlantı noktası, aynı anda bir aracı şarj edebilir. Bir bağlantı noktasında bir veya daha fazla konnektör 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 konnektör bulunabilir ancak aynı anda yalnızca bir aracı şarj edebilirler. Bu nedenle, konnektör sayısı aynı anda şarj edilebilecek toplam araç sayısından fazla olabilir.

connector_aggregation[]

ConnectorAggregation

Aynı türde ve aynı şarj oranına sahip konnektörleri içeren EV şarj konnektörü toplama işlemlerinin listesi.

ConnectorAggregation

[type, max_charge_rate_kw] ile gruplandırılmış elektrikli araç şarj bilgileri. Aynı türde ve kW cinsinden maksimum şarj hızına sahip konnektörlerin EV şarjı toplama işlemini gösterir.

Alanlar
type

EVConnectorType

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

max_charge_rate_kw

double

Toplama işlemindeki her bağlayıcının kW cinsinden statik maksimum şarj hızı.

count

int32

Bu toplama işlemindeki bağlayıcı sayısı.

availability_last_update_time

Timestamp

Bu toplama işlemindeki bağlayıcı kullanılabilirlik bilgilerinin en son güncellendiği zamanın zaman damgası.

available_count

int32

Bu toplama işleminde şu anda kullanılabilen bağlayıcı sayısı.

out_of_service_count

int32

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

EVConnectorType

EV şarj konnektörü türleri hakkında daha fazla bilgi/bağlam için http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 adresini ziyaret edin.

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 türü 1 konnektör.
EV_CONNECTOR_TYPE_TYPE_2 IEC 62196 türü 2 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. Type-1 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 olmayabilir (ör. CCS Combo 2 (CCS2) veya GB/T). Bu değer, gerçek bir konnektör türünü daha az temsil eder ve daha çok Tesla markalı bir aracı Tesla'ya ait 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

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 sahip olduğ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ıra ö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 Belirtilmemiş yakıt türü.
DIESEL Dizel yakıt
DIESEL_PLUS Dizel yakıt.
REGULAR_UNLEADED Normal kurşunsuz.
MIDGRADE 89 Oktan
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 dizeli.

GetPhotoMediaRequest

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

Alanlar
name

string

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

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 istenen maksimum genişliğini belirtir. Resim, belirtilen değerlerden küçükse orijinal resim döndürülür. Resim, boyutlardan herhangi birinde daha büyükse orijinal en boy oranı korunarak iki boyuttan daha küçük olanla eşleşecek şekilde ölçeklendirilir. Hem max_height_px hem de max_width_px özellikleri, 1 ile 4800 arasında (ikisi de 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 ö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 istenen maksimum yüksekliğini belirtir. Resim, belirtilen değerlerden küçükse orijinal resim döndürülür. Resim, boyutlardan herhangi birinde daha büyükse orijinal en boy oranı korunarak iki boyuttan daha küçük olanla eşleşecek şekilde ölçeklendirilir. Hem max_height_px hem de max_width_px özellikleri, 1 ile 4800 arasında (ikisi de 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 ö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ı atlayın ve metin biçiminde (ör. HTTP kullanım alanı için JSON biçiminde) bir yanıt oluşturun. Ayarlanmamışsa çağrıyı resim medyasına yönlendirmek için bir HTTP yönlendirmesi verilir. Bu seçenek, HTTP dışı istekler için yoksayılır.

GetPlaceRequest

Kaynak adına göre bir yer 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östermek için kullanılır. Parametre, geçerli yasaya göre sonuçları etkileyebilir. Daha fazla bilgi için https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html adresine bakın.

3 haneli bölge kodlarının şu anda desteklenmediğini unutmayın.

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ının sorgu yazmaya başlamasıyla başlar, bir yer seçmesi ve Yer Ayrıntıları veya Adres Doğrulama'ya yönelik bir çağrı yapılmasıyla sona erer. Her oturumda birden fazla sorgu olabilir ve bunları bir Yer Ayrıntıları veya Adres Doğrulama isteği takip edebilir. 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 geçerliliğini kaybeder. 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ı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ındaki bilgiler.

Alanlar
name

string

Tanımlayıcı. Bu yer fotoğrafını tekrar aramak için kullanılabilecek, bu yer fotoğrafını temsil eden 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österme bağlantısı.

PhotoMedia

Places API'den alınan bir fotoğraf medyası.

Alanlar
name

string

Fotoğraf medyasının kaynak adı şu biçimdedir: 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ı.

display_name

LocalizedText

Yerin yerelleştirilmiş adı. Kısa ve kullanıcılar tarafından okunabilir bir açıklama olarak uygundur. Örneğin, "Google Sydney", "Starbucks", "Pyrmont" vb.

types[]

string

Bu sonuç için bir dizi tür etiketi. Örneğin, "siyasi" ve "yerel". 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'nin desteklediği 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. Birincil tür, yerin birincil türü desteklenen bir tür değilse eksik olabilir. Birincil tür mevcut olduğunda her zaman types alanındaki türlerden biri olur.

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. Birincil tür, yerin birincil türü desteklenen bir tür değilse eksik olabilir.

national_phone_number

string

Yerin, ulusal biçimde okunabilir telefon numarası.

international_phone_number

string

Yerin uluslararası biçimde, okunabilir telefon numarası.

formatted_address

string

Bu yerin kullanıcılar tarafından okunabilecek tam adresi.

short_formatted_address

string

Bu yer için kısa ve okunabilir bir adres.

postal_address

PostalAddress

Posta adresi biçimindeki adres.

address_components[]

AddressComponent

Her yerleşim birimi seviyesi için tekrarlanan bileşenler. address_components[] dizisiyle ilgili aşağıdaki bilgileri unutmayın: - Adres bileşenleri dizisi, formatted_address'ten daha fazla bileşen içerebilir. - Dizi, formatted_address içinde yer alanlar dışında, adres içeren tüm siyasi varlıkları içermeyebilir. Belirli bir adresi içeren tüm siyasi varlıkları almak için ters coğrafi kodlama kullanmanız ve isteğe parametre olarak adresin enlem/boylamını iletmeniz 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 dizideki konumunu değiştirebilir. Bileşenin türü değişebilir. Belirli bir bileşen sonraki yanıtlarda eksik olabilir.

plus_code

PlusCode

Yerin konumunun enlem/boylam Plus Code'u.

location

LatLng

Bu yerin konumu.

viewport

Viewport

Yeri ortalama büyüklükteki bir haritada göstermeye uygun bir görüntü alanı. Bu görünüm 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 dayalı olarak 1,0 ile 5,0 arasında bir puan.

google_maps_uri

string

Bu yer hakkında daha fazla bilgi veren 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 bunun genellikle zincirin tamamı değil, bağımsız mağazanın web sitesi olacağını unutmayın.

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. Müşteriler, her zaman açık (24 saat) olan işletmelerin 0 değeriyle open, 0 değeriyle day ve 0 değeriyle hour içeren bir minute dönemi olarak gösterileceğine güvenebilir.

time_zone

TimeZone

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

photos[]

Photo

Bu yerin fotoğraflarıyla ilgili bilgiler (referanslar dahil). En fazla 10 fotoğraf döndürülebilir.

adr_format_address

string

Yerin adresi, adr mikro biçiminde: 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 dizi veri sağlayıcı.

icon_mask_base_uri

string

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

icon_background_color

string

Onaltılık biçimde icon_mask için 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ında başlar ve altı gün sonra saat 23:59'da sona erer. Bu alan, olağan dışı çalışma saatlerinin olduğu tarihler için ayarlanan tüm saatlerin 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 temel çalışma saatlerinden farklıdır. Örneğin, bir restoran, arabaya servis saatlerini veya teslimat saatlerini ikincil çalışma saatleri olarak belirtebilir. Bu alan, yer türlerine göre önceden tanımlanmış bir çalışma saatleri türleri listesinden (ör. DRIVE_THROUGH, PICKUP veya TAKEOUT) alınan tür alt alanını doldurur. Bu alan, olağan dışı çalışma saatlerinin olduğu tarihler için ayarlanan tüm saatlerin special_days alt alanını içerir.

regular_secondary_opening_hours[]

OpeningHours

Bir işletmenin normal ikincil çalışma saatleriyle ilgili bilgilerin yer aldığı bir dizi giriş içerir. İkincil çalışma saatleri, işletmenin temel çalışma saatlerinden farklıdır. Örneğin, bir restoran, arabaya servis saatlerini veya teslimat saatlerini ikincil çalışma saatleri olarak belirtebilir. Bu alan, yer türlerine göre önceden tanımlanmış bir çalışma saatleri türleri listesinden (ör. DRIVE_THROUGH, PICKUP veya TAKEOUT) 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 geçerli durumlarda bu öğelerin dil kodunu da içerir. Özet metni olduğu gibi sunulmalı, değiştirilmemeli veya üzerinde oynanmamalıdır.

payment_options

PaymentOptions

Mekanın kabul ettiği ödeme seçenekleri. Bir ödeme seçeneği verisi kullanılamıyorsa ödeme seçeneği alanı ayarlanmamış olur.

parking_options

ParkingOptions

Mekanın sunduğu 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

EV şarj seçenekleri hakkında bilgi.

generative_summary

GenerativeSummary

Yerin yapay zekayla üretilmiş ö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ı, önemli noktaları ve alanları kullanarak bir konumu tanımlamaya yardımcı olan ek bilgiler içerir. Adres tanımlayıcı bölgesel kapsamı için https://developers.google.com/maps/documentation/geocoding/address-descriptors/coverage adresini ziyaret edin.

price_range

PriceRange

Bir yerle ilişkili fiyat aralığı.

review_summary

ReviewSummary

Kullanıcı yorumları kullanılarak yerin yapay zeka tarafından üretilmiş özeti.

ev_charge_amenity_summary

EvChargeAmenitySummary

Elektrikli araç şarj istasyonunun yakınındaki olanakların özeti.

neighborhood_summary

NeighborhoodSummary

Yerin yakınındaki önemli yerlerin özeti.

consumer_alert

ConsumerAlert

Bir işletmede şüpheli yorum etkinliği tespit ettiğimizde veya bir işletme politikalarımızı ihlal ettiğinde yerle ilgili tüketici uyarısı mesajı.

utc_offset_minutes

int32

Bu yerin saat diliminin şu anda UTC'den kaç dakika uzaklıkta olduğu. Bu değer, saat dilimlerinin saatten daha kısa sürelerle (ör. X saat 15 dakika) farklılık göstermesini 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 seçeneğini destekleyip desteklemediğini belirtir.

delivery

bool

İşletmenin teslimatı destekleyip desteklemediğini belirtir.

dine_in

bool

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

curbside_pickup

bool

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

reservable

bool

Mekanın rezervasyonları destekleyip desteklemediğini belirtir.

serves_breakfast

bool

Mekanda kahvaltı servisi olup olmadığını belirtir.

serves_lunch

bool

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

serves_dinner

bool

Mekanda 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 olup olmadığını belirtir.

serves_brunch

bool

Mekanda 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

Mekanda açık havada oturma alanı vardır.

live_music

bool

Mekanda canlı müzik vardır.

menu_for_children

bool

Çocuk menüsü var.

serves_cocktails

bool

Mekanda kokteyl servisi var.

serves_dessert

bool

Tatlı servisi var.

serves_coffee

bool

Kahve servisi var.

good_for_children

bool

Çocuklar için uygun bir yer.

allows_dogs

bool

Mekana köpek kabul ediliyor.

restroom

bool

Tuvalet var.

good_for_groups

bool

Mekanda gruplar ağırlanır.

good_for_watching_sports

bool

Mekanda spor etkinlikleri izlenebilir.

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 teslimat yapan ancak işletme adresinde müşterilere hizmet vermeyen işletmelerdir. Örneğin, temizlik veya tesisatçılık hizmeti sunan işletmeler. Bu işletmelerin Google Haritalar'da fiziksel 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 sunuluyor.

wheelchair_accessible_entrance

bool

Mekanda tekerlekli sandalyeye uygun giriş var.

wheelchair_accessible_restroom

bool

Tesis, tekerlekli sandalye kullanıcılarına uygun tuvalete sahiptir.

wheelchair_accessible_seating

bool

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

AddressComponent

Biçimlendirilmiş adresi oluşturan yapılandırılmış bileşenler (bu bilgi varsa).

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 "Australia" olabilir.

short_text

string

Varsa adres bileşeninin 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 gösterimiyle).

İlişkilendirme

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

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ılmıyor.
OPERATIONAL Tesis faaliyet gösteriyor ancak şu anda açık olmayabilir.
CLOSED_TEMPORARILY Tesis geçici olarak kapalı.
CLOSED_PERMANENTLY Tesis kalıcı olarak kapatıldı.

ConsumerAlert

Bir işletmede şüpheli yorum etkinliği tespit ettiğimizde veya bir işletme politikalarımızı ihlal ettiğinde yerle ilgili tüketici uyarısı mesajı.

Alanlar
overview

string

Tüketici uyarısı mesajına genel bakış.

details

Details

Tüketici uyarısı mesajının ayrıntıları.ƒ

language_code

string

Tüketici uyarısı mesajının dil kodu. Bu, BCP 47 dil kodudur.

Ayrıntılar

Tüketici uyarısı mesajının ayrıntıları.

Alanlar
title

string

Açıklamayla birlikte gösterilecek başlık.

description

string

Tüketici uyarısı mesajının açıklaması.

ContainingPlace

Bu yerin bulunduğu yerle ilgili bilgiler.

Alanlar
name

string

Bu yerin bulunduğu yerin kaynak adı.

id

string

Bu yerin bulunduğu yerin yer kimliği.

EvChargeAmenitySummary

Elektrikli araç şarj istasyonunun yakınındaki olanakların özeti. Bu yalnızca electric_vehicle_charging_station türündeki yerler için geçerlidir. overview alanı sağlanır ancak diğer alanlar isteğe bağlıdır.

Alanlar
overview

ContentBlock

Mevcut olanaklara genel bakış. Bu hizmetin sağlanacağı garanti edilir.

coffee

ContentBlock

Yakındaki kahve seçeneklerinin özeti.

restaurant

ContentBlock

Yakındaki restoranların özeti.

store

ContentBlock

Yakındaki mağazaların özeti.

flag_content_uri

string

Kullanıcıların özetle ilgili sorunları bildirebileceği bir bağlantı.

disclosure_text

LocalizedText

"Gemini ile özetlendi" yapay zeka açıklama mesajı (ve yerelleştirilmiş varyantları). Bu bilgi, varsa istekte belirtilen dilde sunulur.

GenerativeSummary

Yerin yapay zekayla üretilmiş özeti.

Alanlar
overview

LocalizedText

Yere genel bakış.

overview_flag_content_uri

string

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

disclosure_text

LocalizedText

"Gemini ile özetlendi" yapay zeka açıklama mesajı (ve yerelleştirilmiş varyantları). Bu bilgi, varsa istekte belirtilen dilde sunulur.

NeighborhoodSummary

Yerin yakınındaki önemli yerlerin özeti.

Alanlar
overview

ContentBlock

Mahallenin genel bir özeti.

description

ContentBlock

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

flag_content_uri

string

Kullanıcıların özetle ilgili sorunları bildirebileceği bir bağlantı.

disclosure_text

LocalizedText

"Gemini ile özetlendi" yapay zeka açıklama mesajı (ve yerelleştirilmiş varyantları). Bu bilgi, varsa istekte belirtilen dilde sunulur.

OpeningHours

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

Alanlar
periods[]

Period

Bu yerin hafta içinde açık olduğu dönemler. Dönemler, yerel saat dilimine göre kronolojik sırada gösterilir. Boş (ancak eksik olmayan) bir değer, hiçbir zaman açık olmayan bir yeri (ör. tadilat nedeniyle geçici olarak kapalı) gösterir.

periods başlangıç günü sabit DEĞİLDİR ve pazar günü olduğu varsayılmamalıdır. API, başlangıç gününü çeşitli faktörlere göre belirler. Örneğin, 7/24 hizmet veren bir işletmede ilk dönem, istek gününde başlayabilir. Diğer işletmeler için ise işletmenin açık olduğu ilk gün olabilir.

NOT: periods dizisinin sıralaması, weekday_descriptions dizisinin sıralamasından bağımsızdır. Aynı gün başlayacaklarını varsaymayın.

weekday_descriptions[]

string

Bu yerin çalışma saatlerini açıklayan yerelleştirilmiş dizeler. Haftanın her günü için bir dize.

NOT: Günlerin sırası ve haftanın başlangıcı yerel ayara (dil ve bölge) göre belirlenir. periods dizisinin sıralaması, weekday_descriptions dizisinin sıralamasından bağımsızdır. Aynı gün başlayacaklarını varsaymayın.

Saatler bilinmiyorsa veya yerelleştirilmiş metne dönüştürülemiyorsa boş olur. Örnek: "Pazar: 18:00–06:00"

secondary_hours_type

SecondaryHoursType

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

special_days[]

SpecialDay

Döndürülen çalışma saatlerinin kapsadığı dönemde yer alan özel günlerle ilgili yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir (ör. Noel). Çalışma saatlerinde istisnai durumlar varsa current_opening_hours ve current_secondary_opening_hours için ayarlayın.

next_open_time

Timestamp

Mevcut çalışma saatleri dönemi, 7 gün içinde tekrar başlayacak. 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önemi, bir sonraki sefer 7 gün içinde sona erer. Bu alan yalnızca istek sunulduğu sırada çalışma saatleri 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ı gösterir. İkincil çalışma saatleri ve mevcut ikincil çalışma saatleri için bu alan, yerin ikincil çalışma saatlerinin etkin olup olmadığını ifade eder.

Dönem

Yerin open_now durumunda kaldığı süre.

Alanlar
open

Point

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

close

Point

Yerlerin kapanmaya başladığı saat.

Nokta

Durum değiştirme noktaları.

Alanlar
date

Date

Yerel saat dilimindeki tarih.

truncated

bool

Bu uç noktanın kısaltılıp kısaltılmadığı. Gerçek saatler, saat iadesi yapmaya hazır olduğumuz zamanların dışında olduğunda kısaltma gerçekleşir. Bu nedenle, saatleri bu sınırlar içinde kısaltırız. Bu, istek gününün gece yarısından itibaren en fazla 24 * 7 saatlik verilerin döndürülmesini sağlar.

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

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

SecondaryHoursType

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

Sıralamalar
SECONDARY_HOURS_TYPE_UNSPECIFIED İkincil saat türü belirtilmediğinde kullanılan varsayılan değer.
DRIVE_THROUGH Bankalar, restoranlar veya eczaneler için arabaya servis saatleri.
HAPPY_HOUR İndirimli saatler
DELIVERY Teslimat saati.
TAKEOUT Paket servis 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 yerlerinin 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önemde yer alan özel günlerle ilgili yapılandırılmış bilgiler. Özel günler, bir yerin çalışma saatlerini etkileyebilecek günlerdir (ör. Noel).

Alanlar
date

Date

Bu özel günün tarihi.

ParkingOptions

Yer için park yeri seçenekleri hakkında bilgiler. Bir otopark aynı anda birden fazla seçeneği destekleyebilir.

Alanlar
free_parking_lot

bool

Tesiste ücretsiz otopark mevcuttur.

paid_parking_lot

bool

Tesis ücretli otopark sunar.

free_street_parking

bool

Mekanda cadde üzerinde ücretsiz otopark mevcuttur.

paid_street_parking

bool

Mekanda ücretli cadde otoparkı mevcuttur.

valet_parking

bool

Vale park hizmeti sunulur.

free_garage_parking

bool

Tesiste ücretsiz kapalı otopark mevcuttur.

paid_garage_parking

bool

Mekanda ücretli kapalı otopark mevcuttur.

PaymentOptions

Mekanın kabul ettiği ödeme seçenekleri.

Alanlar
accepts_credit_cards

bool

Mekanda ödeme olarak kredi kartı kabul ediliyor.

accepts_debit_cards

bool

Ödeme için banka kartı kabul ediliyor.

accepts_cash_only

bool

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

accepts_nfc

bool

İşletme, NFC ödemelerini kabul ediyor.

PlusCode

Plus code (http://plus.codes), iki biçimi olan bir konum referansıdır: 14 m x 14 m (1/8000 derece) veya daha küçük bir dikdörtgeni tanımlayan global kod ve öneki bir referans konumla değiştiren bileşik kod.

Alanlar
global_code

string

"9FWM33GV+HQ" gibi, 1/8000 dereceye 1/8000 derece (yaklaşık 14 x 14 metre) alanı temsil eden yerin global (tam) kodu.

compound_code

string

Küresel kodun sonekini içeren ve öneki biçimlendirilmiş bir referans öğesi adıyla değiştiren, yerin bileşik kodu (ör. "33GV+HQ, Ramberg, Norveç").

ReviewSummary

Kullanıcı yorumları kullanılarak yerin yapay zeka tarafından üretilmiş özeti.

Alanlar
text

LocalizedText

Kullanıcı yorumlarının özeti.

flag_content_uri

string

Kullanıcıların özetle ilgili sorunları bildirebileceği bir bağlantı.

disclosure_text

LocalizedText

"Gemini ile özetlendi" yapay zeka açıklama mesajı (ve yerelleştirilmiş varyantları). Bu bilgi, varsa istekte belirtilen dilde sunulur.

reviews_uri

string

Bu yerle ilgili yorumları Google Haritalar'da gösterme bağlantısı.

SubDestination

Alt hedefler, ana bir yerle ilişkili belirli yerlerdir. Bu bağlantılar, havaalanı, milli park, üniversite veya stadyum gibi büyük ya da karmaşık bir yerde arama yapan kullanıcılar için daha spesifik hedefler sunar. Örneğin, bir havalimanındaki alt hedefler arasında ilgili terminaller ve otoparklar yer alabilir. Alt hedefler, yerin görünen adı ve konumu da dahil olmak üzere daha ayrıntılı bilgiler getirmek için sonraki Yer Ayrıntıları (Yeni) isteklerinde kullanılabilecek yer kimliğini ve yer kaynağı adını döndürür.

Alanlar
name

string

Alt hedefin kaynak adı.

id

string

Alt hedefin yer kimliği.

Çoklu çizgi

Rota çoklu çizgisi. Yalnızca dize olarak iletilebilen ve minimum kayıpla sıkıştırma içeren kodlanmış çoklu çizgi desteklenir. Bu, Routes API'nin varsayılan çıkışıdır.

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

string

Varsayılan olarak Routes API tarafından döndürülen bir kodlanmış çoklu ç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 Mekanda ücretsiz hizmetler sunuluyor.
PRICE_LEVEL_INEXPENSIVE Mekanda uygun fiyatlı hizmetler sunuluyor.
PRICE_LEVEL_MODERATE Mekanda orta fiyatlı hizmetler sunuluyor.
PRICE_LEVEL_EXPENSIVE Mekanda pahalı hizmetler sunuluyor.
PRICE_LEVEL_VERY_EXPENSIVE Çok pahalı hizmetler sunuluyor.

PriceRange

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

Alanlar
start_price

Money

Fiyat aralığının alt sınırı (dahil). Fiyat bu tutara eşit 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.

İncele

Bir yerin yorumuyla ilgili bilgiler

Alanlar
name

string

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

relative_publish_time_description

string

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

text

LocalizedText

Yorumun yerelleştirilmiş metni.

original_text

LocalizedText

Yorum metni orijinal dilinde.

rating

double

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

author_attribution

AuthorAttribution

Bu yorumun yazarı.

publish_time

Timestamp

Yorumun 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österme bağlantısı.

visit_date

Date

Yazarın yeri ziyaret ettiği tarih. Bu değer ay olarak kısaltılır.

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, ücretli yolların olmadığı rotalara öncelik vererek mümkün olduğunda ücretli yollardan kaçınılır. Yalnızca DRIVE ve TWO_WHEELER TravelMode için geçerlidir.

avoid_highways

bool

İsteğe bağlı. Doğru olarak ayarlandığında, otoyol içermeyen rotalara öncelik vererek mümkün olduğunda otoyollardan kaçınılır. Yalnızca DRIVE ve TWO_WHEELER TravelMode için geçerlidir.

avoid_ferries

bool

İsteğe bağlı. Doğru olarak ayarlandığında, makul durumlarda feribotları kullanmaktan kaçınılır ve feribot içermeyen rotalar tercih edilir. Yalnızca DRIVE ve TWO_WHEELER TravelMode için geçerlidir.

avoid_indoor

bool

İsteğe bağlı. Doğru olarak ayarlandığında, makul olan durumlarda iç mekanlarda gezinmeyi önler ve iç mekan navigasyonu içermeyen rotalara öncelik verir. Yalnızca WALK TravelMode için geçerlidir.

RoutingParameters

Hem bir rota boyunca (sonuç sıralaması etkilenecek) hem de sonuçlardaki seyahat sürelerini hesaplamak için yönlendirme hesaplamalarını yanıttaki yerlere göre yapılandırma parametreleri.

Alanlar
origin

LatLng

İsteğe bağlı. Çoklu çizgide tanımlanan kaynağı geçersiz kılan açık bir yönlendirme kaynağı. Varsayılan olarak, çoklu çizgi kaynağı 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. Trafiğe duyarlı yönlendirme tercihi yalnızca DRIVE veya TWO_WHEELER travelMode için kullanılabilir.

RoutingPreference

Rotayı hesaplarken dikkate alınacak faktörleri belirten bir değerler grubu.

Sıralamalar
ROUTING_PREFERENCE_UNSPECIFIED Yönlendirme tercihi belirtilmedi. Varsayılan olarak TRAFFIC_UNAWARE değerine ayarlanır.
TRAFFIC_UNAWARE Canlı trafik koşullarını dikkate almadan rotalar hesaplar. Trafik koşullarının önemli olmadığı veya geçerli olmadığı durumlarda 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 ortalama zamandan bağımsız trafik koşullarına göre belirlenir. Bu nedenle, rotalarda geçici olarak kapalı olan yollar yer alabilir. Belirli bir isteğ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şebilir. Sonuçlar, neredeyse eşdeğer rotalar arasında da herhangi bir zamanda veya sıklıkta değişiklik gösterebilir.
TRAFFIC_AWARE Canlı trafik koşullarını dikkate alarak rotaları hesaplar. TRAFFIC_AWARE_OPTIMAL'nın aksine, bazı optimizasyonlar gecikmeyi önemli ölçüde azaltmak için uygulanır.
TRAFFIC_AWARE_OPTIMAL Çoğu performans optimizasyonu uygulanmadan, canlı trafik koşullarını dikkate alan rotaları hesaplar. Bu değeri kullanmak en yüksek gecikmeye neden olur.

RoutingSummary

Yanıttaki bir yere kadar olan rotanın süresi ve mesafesi ile istenirse bu yerden varış noktasına kadar olan ikinci etap. Not: İstekte routingParameters.origin parametresi veya searchAlongRouteParameters.polyline.encodedPolyline parametresi de eklenmeden alan maskesine routingSummaries eklenmesi hataya neden olur.

Alanlar
legs[]

Leg

Gezinin bölümleri.

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

directions_uri

string

Belirli rota özetindeki yol noktalarını kullanarak Google Haritalar'da yol tariflerini göstermek için kullanılan 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 kullanır. Bu bilgiler, geçerli olduğunda routingParameters ve searchAlongRouteParameters gibi alanlardaki bilgileri içerir.

Ayak

Ayak, bir yolculuğun bir konumdan diğerine olan tek bir bölümüdür.

Alanlar
duration

Duration

Gezinin bu ayağının tamamlanması için gereken süre.

distance_meters

int32

Gezinin bu ayağının mesafesi.

SearchNearbyRequest

Yakınlarda Arama için istek proto'su.

Alanlar
language_code

string

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

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östermek için kullanılır. Parametre, geçerli yasaya göre sonuçları etkileyebilir.

Daha fazla bilgi için https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html adresine bakın.

3 haneli bölge kodlarının şu anda desteklenmediğini unutmayın.

included_types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types adresindeki dahil edilen yer türü (ör. "restaurant" veya "gas_station").

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

Çakışan türler varsa (ör. bir tür hem 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 öncelikli olarak "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ğlıyorsa yanıtta restoran olan ancak kafe olmayan yerler yer almalıdır. Yanıtta, included_types'lardan en az biriyle eşleşen ve excluded_types'lardan hiçbiriyle eşleşmeyen yerler yer alır.

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

included_primary_types[]

string

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

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

Çakışan birincil türler varsa (ör. bir tür hem 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 öncelikli olarak "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 öncelikli olarak "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ı ayarlanmamışsa üst sınıra geri döner. Sayı negatif olarak ayarlanırsa veya üst sınırı aşarsa INVALID_ARGUMENT hatası döndürülür.

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

type birleşik alanı.

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ında Arama için yanıt protosu.

Alanlar
places[]

Place

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

routing_summaries[]

RoutingSummary

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

SearchTextRequest

SearchText için istek protosu.

Alanlar
text_query

string

Zorunlu. Metin araması için metin sorgusu.

language_code

string

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

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östermek için kullanılır. Parametre, geçerli yasaya göre sonuçları etkileyebilir.

Daha fazla bilgi için https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html adresine bakın.

3 haneli bölge kodlarının şu anda desteklenmediğini unutmayın.

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ı şu anda açık olan yerlerle sınırlandırmak için kullanılır. Varsayılan değer false'tur.

min_rating

double

Ortalama kullanıcı puanı bu sınırdan kesinlikle daha düşük olan sonuçları filtreleyin. Geçerli bir değer, 0 ile 5 arasında (bu değerler dahil) 0,5 aralıklarla değişen bir kayan nokta olmalıdır. Örneğin, [0, 0,5, 1,0, ..., 5,0] bu değerler dahil. Giriş derecelendirmesi en yakın 0,5'e(tavan) yuvarlanır. Örneğin, 0,6 puanı, 1,0'dan düşük puan alan tüm sonuçları eler.

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ı. Kullanılabilir sonuç sayısı max_result_count değerinden büyükse next_page_token döndürülür. Bu değer, sonraki isteklerde sonuçların bir sonraki sayfasını almak için page_token işlevine iletilebilir. 0 veya değer belirtilmezse 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ı. Kullanılabilir sonuç sayısı page_size değerinden büyükse next_page_token döndürülür. Bu değer, sonraki isteklerde sonuçların bir sonraki sayfasını almak için page_token işlevine iletilebilir. 0 veya değer belirtilmezse varsayılan olarak 20 kullanılır. Maksimum değer 20'dir. 20'den büyük 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.

Sayfalama yapılı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 INVALID_ARGUMENT hatası döndürülür.

price_levels[]

PriceLevel

Aramayı belirli fiyat seviyeleri olarak işaretlenmiş yerlerle sınırlandırmak için kullanılır. Kullanıcılar, fiyat seviyelerinin herhangi bir kombinasyonunu seçebilir. Varsayılan olarak tüm fiyat seviyeleri seçilir.

strict_type_filtering

bool

included_type için katı tür filtreleme ayarlamak üzere kullanılır. Doğru olarak ayarlanırsa yalnızca aynı türdeki sonuçlar döndürülür. Varsayılan değer false'tur.

location_bias

LocationBias

Aranacak bölge. Bu konum, sonuçların belirli bir konumun çevresinde döndürülmesine neden olan bir önyargı olarak işlev görür. location_restriction ile birlikte ayarlanamaz.

location_restriction

LocationRestriction

Aranacak bölge. Bu konum, kısıtlama olarak işlev görür. Bu nedenle, 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 EV seçeneklerini ayarlayın.

routing_parameters

RoutingParameters

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

search_along_route_parameters

SearchAlongRouteParameters

İsteğe bağlı. Rota üzerinde arama için ek parametreler proto'su.

include_pure_service_area_businesses

bool

İsteğe bağlı. Alan doğru 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 teslimat yapan ancak işletme adresinde müşterilere hizmet vermeyen işletmelerdir. Örneğin, temizlik veya tesisatçılık hizmeti sunan işletmeler. Bu işletmelerin Google Haritalar'da fiziksel adresi veya konumu yoktur. Places, 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 şarj hızı. Belirtilen orandan daha düşük bir şarj oranına sahip 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, sonuçların belirli bir konumun çevresinde döndürülmesine neden olan bir önyargı olarak işlev görür.

Alanlar

type birleşik alanı.

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

rectangle

Viewport

Kuzeydoğu ve güneybatı köşeleriyle tanımlanan dikdörtgen kutu. rectangle.high(), dikdörtgen görünüm alanının kuzeydoğu noktası olmalıdır. rectangle.low(), dikdörtgen görünüm alanının güneybatı noktası olmalıdır. rectangle.low().latitude(), rectangle.high().latitude() değerinden büyük olamaz. Bu durumda enlem aralığı boş 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, kısıtlama olarak işlev görür. Bu nedenle, belirtilen konumun dışındaki sonuçlar döndürülmez.

Alanlar

type birleşik alanı.

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

rectangle

Viewport

Kuzeydoğu ve güneybatı köşeleriyle tanımlanan dikdörtgen kutu. rectangle.high(), dikdörtgen görünüm alanının kuzeydoğu noktası olmalıdır. rectangle.low(), dikdörtgen görünüm alanının güneybatı noktası olmalıdır. rectangle.low().latitude(), rectangle.high().latitude() değerinden büyük olamaz. Bu durumda enlem aralığı boş 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 ALAKA DÜZEYİ'dir. "Mountain View, CA" gibi kategorik olmayan sorgular için rankPreference'ı ayarlanmamış olarak 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ına göre belirlenir.

SearchAlongRouteParameters

Aranacak rotayı tanımlayan Routes API'den önceden hesaplanmış bir çoklu çizgi 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ı etkileyecek bir bölge belirtmenize olanak tanırken bu seçenek, sonuçları bir gezi rotası boyunca etkilemenize olanak tanır.

Sonuçların, sağlanan rotada olacağı garanti edilmez. Bunun yerine, çoklu çizgiyle ve isteğe bağlı olarak locationBias veya locationRestriction ile tanımlanan arama alanında, başlangıç noktasından varış noktasına minimum sapma sürelerine göre sıralanır. Sonuçlar, özellikle sağlanan çoklu çizgi başlangıç noktasından varış noktasına giden ideal bir rotayı tanımlamıyorsa alternatif bir rota üzerinde olabilir.

Alanlar
polyline

Polyline

Zorunlu. Rota çoklu çizgisi.

SearchTextResponse

SearchText için yanıt proto'su.

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

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ı dizinde 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ğlamsal olmayan içerik döndürülür. Bu alan yalnızca içerik bu yer için kullanılamadığında boş olur. Bu listede, istenirse yerler listesindeki kadar giriş bulunur.

next_page_token

string

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

search_uri

string

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

TravelMode

Ulaşım şekli seçenekleri. Bu seçenekler, Routes API'nin sunduğu seçeneklerle eşleşir.

Sıralamalar
TRAVEL_MODE_UNSPECIFIED Ulaşım şekli belirtilmedi. Varsayılan olarak DRIVE değerine ayarlanır.
DRIVE Binek otomobille 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ç. Bu seçeneğin, 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.