Package google.maps.geocode.v4alpha

Dizin

DestinationService

Hedefleri almak için kullanılan bir hizmet.

Hedef, bir yer hakkında hiyerarşik bağlam sağlar. Bu sayede, örneğin daha büyük bir apartman kompleksindeki apartman binalarını ve tam tersini bulabilirsiniz. Ayrıca, araç paylaşımı veya teslimat gibi kullanım alanlarına uygun gezinme noktaları da sağlar.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Bu yöntem, hedef arama işlemi gerçekleştirir ve hedeflerin listesini döndürür.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

GeocodeService

Coğrafi kodlama gerçekleştirme hizmeti.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Bu yöntem, bir adresi LatLng'ye eşleyen bir adres coğrafi kodu oluşturur. Ayrıca adres hakkında yapılandırılmış bilgiler de sağlar.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse)

Bu yöntem, bir LatLng'yi adresle eşleyen bir konum coğrafi kodu oluşturur. Ayrıca adres hakkında yapılandırılmış bilgiler de sağlar.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult)

Bu yöntemde, yer kimliği kullanılarak coğrafi kod arama işlemi gerçekleştirilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Hedef

Bir hedef. Buna birincil yer, ilgili yerler, girişler ve gezinme noktaları dahildir.

Alanlar
primary

PlaceView

İstekle ilgili primary_query tarafından tanımlanan birincil yer.
containing_places[]

PlaceView

Birincil yerin içinde bulunduğu daha az hassas yerler. Örneğin, bu binanın bulunduğu apartman kompleksi.
sub_destinations[]

PlaceView

Birincil yerin daha kesin alt hedefleri. Örneğin, bir binada bulunan birimler.

Not: Bu alt hedef listesi, Places API tarafından döndürülen SubDestination ile karşılaştırıldığında daha kapsamlıdır ve her alt hedef daha fazla bilgi içerir.
landmarks[]

Landmark

Hedefin nerede olduğunu bildirmek veya varışa yardımcı olmak için kullanılabilecek önemli noktalar.
entrances[]

Entrance

Bu varış noktası için girişler.
navigation_points[]

NavigationPoint

Bu varış noktası için gezinme noktaları.
parking_options

Destination.ParkingOptions

Bu varış noktası için otopark seçenekleri.
arrival_summary

Destination.ArrivalSummary

Hedefe varış deneyiminin yapay zekayla üretilmiş özeti.

ArrivalSummary

Hedefe varış deneyiminin yapay zekayla üretilmiş özeti.

Alanlar
text

LocalizedText

Hedefe varış deneyiminin özeti.
flag_content_url

string

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

LocalizedText

Yalnızca çıkış. Varış özetiyle ilgili açıklama metnini içerir.

ParkingOptions

Hedefteki otopark seçenekleri hakkında bilgi.

Alanlar
availability

Destination.ParkingOptions.Availability

Bu hedef için otoparkın müsaitlik durumu.
onsite_parking

bool

Hedefte tesis içi otopark vardır.
free_parking_lot

bool

Ücretsiz otoparklar sunar.
paid_parking_lot

bool

Ücretli otoparklar sunar.
free_street_parking

bool

Cadde üzerinde ücretsiz park yeri sunar.
paid_street_parking

bool

Cadde üzerinde ücretli park yeri sunar.
valet_parking

bool

Vale park hizmeti sunar.
free_garage_parking

bool

Ücretsiz kapalı otopark sunar.
paid_garage_parking

bool

Ücretli kapalı otopark sunar.

Kullanılabilirlik

Bu yeri ziyaret ederken park yeri bulmanın ne kadar zor olduğuna dair toplu bir ölçü.

Gelecekte yeni değerler eklenebilir.

Sıralamalar
AVAILABILITY_UNSPECIFIED Otopark durumu bilgisi mevcut değil.
PLENTY Yeterli sayıda park yeri mevcuttur.
SOMEWHAT_DIFFICULT Park yeri bulmak biraz zor.
DIFFICULT Park yeri bulmak çok zor.

Giriş

Giriş, bir yerin giriş ve çıkış noktasının konumunu tanımlayan tek bir enlem/boylam koordinat çiftidir.

Alanlar
location

LatLng

Girişin konumu.
tags[]

Entrance.Tag

Girişi açıklayan etiketlerin listesi.
place

string

Bu girişin fiziksel olarak bulunduğu yapı, places/{place_id} biçiminde.
street_view_thumbnail

StreetViewThumbnail

Girişi gösteren Street View küçük resmi. Görüntü, Street View Static API'den istenebilir. https://developers.google.com/maps/documentation/streetview/request-streetview adresini ziyaret edin.
street_view_annotation

ImageAnnotation

Yukarıda döndürülen street_view_thumbnail girişinin açıklaması.

Etiket

Bir girişi tanımlayan özellikler.

Sıralamalar
TAG_UNSPECIFIED Kullanılmıyor.
PREFERRED

Giriş, döndürülen hedefteki birincil yere fiziksel erişim sağlıyor olabilir. Bir yerin birden fazla tercih edilen girişi olabilir. Bir girişin bu etiketi yoksa girişin fiziksel olarak birincil yerle aynı binada olduğu ancak yere erişim sağlamadığı anlamına gelir.

Örneğin, birincil yer bir alışveriş merkezindeki bir restoransa "TERCİH EDİLEN" girişler büyük olasılıkla doğrudan restorana giden girişler olur. Diğer girişler ise binanın diğer girişleri (ör. alışveriş merkezindeki diğer restoranların girişleri) olur.

Birincil yerin kendisi bir binaysa PREFERRED girişleri, binanın "ana" kısmına giden girişler olur. Örneğin, bir alışveriş merkezinde ana fuaye alanına erişime izin veren girişler PREFERRED girişleridir. Ancak bir giriş yalnızca binanın yan tarafındaki bir mağazaya erişim sağlıyorsa bu giriş PREFERRED girişi olmaz.

Not: PREFERRED giriş, birincil yere erişim sağlamayabilir ve PREFERRED olmayan bir giriş, birincil yere erişim sağlayabilir.

GeocodeAddressRequest

GeocodeService.GeocodeAddress için istek mesajı.

Alanlar
location_bias

GeocodeAddressRequest.LocationBias

İsteğe bağlı. Arama yapılacak bölge. Bu konum, sonuçların tercih edildiği bir önyargı olarak kullanılır.
language_code

string

İsteğe bağlı. Sonuçların döndürülmesi gereken dil.
region_code

string

İsteğe bağlı. Bölge kodu. Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen iki karakterli bir değerdir. Parametre, geçerli yasaya göre sonuçları etkiler. Bu parametre, hizmetten alınan sonuçları da etkiler ancak tamamen kısıtlamaz.
address_input birleşik alanı. Coğrafi kodlanacak adres. address_input aşağıdakilerden yalnızca biri olabilir:
address_query

string

Coğrafi kodlanacak yapılandırılmamış adres.
address

PostalAddress

Posta adresi biçiminde coğrafi kodlaması yapılacak yapılandırılmış adres.

LocationBias

Arama yapılacak bölge. Bu konum, sonuçların tercih edildiği bir önyargı olarak kullanılır.

Alanlar
type birleşik alanı. Konum yanlılığı türleri. type aşağıdakilerden yalnızca biri olabilir:
rectangle

Viewport

Kuzeydoğu ve güneybatı köşesiyle 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.

GeocodeAddressResponse

GeocodeService.GeocodeAddress için yanıt mesajı.

Alanlar
results[]

GeocodeResult

Coğrafi kodlama sonucu.

GeocodeLocationRequest

GeocodeService.GeocodeLocation için istek mesajı.

Alanlar
language_code

string

İsteğe bağlı. Sonuçların döndürülmesi gereken dil.
region_code

string

İsteğe bağlı. Bölge kodu. Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen iki karakterli bir değerdir. Parametre, geçerli yasaya göre sonuçları etkiler.
types[]

string

İsteğe bağlı. Sonuçları kısıtlamak için kullanılan bir tür etiketleri grubu. Belirtilen türlerden hiçbirine sahip olmayan sonuçlar kaldırılır.

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.
granularity[]

GeocodeResult.Granularity

İsteğe bağlı. Bir veya daha fazla konum ayrıntısı enum'ı filtresi.
location_input birleşik alanı. Coğrafi kodlanacak konum. location_input aşağıdakilerden yalnızca biri olabilir:
location_query

string

"lat,lng" dizesi biçimindeki konum. Örneğin, "64.7611872,-18.4705364".
location

LatLng

Yapılandırılmış biçimdeki konum.

GeocodeLocationResponse

GeocodeService.GeocodeLocation için yanıt mesajı.

Alanlar
results[]

GeocodeResult

Coğrafi kodlama sonucu.
plus_code

PlusCode

İstekteki konumun Plus Code'u.

GeocodePlaceRequest

GeocodeService.GeocodePlace için istek mesajı.

Alanlar
place

string

Zorunlu. Yer/yer biçiminde coğrafi kodlaması yapılacak yer tanımlayıcısı.
language_code

string

İsteğe bağlı. Sonuçların döndürülmesi gereken dil.
region_code

string

İsteğe bağlı. Bölge kodu. Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen iki karakterli bir değerdir. Parametre, geçerli yasaya göre sonuçları etkiler.

GeocodeResult

Bir coğrafi kod sonucu, bir yerle ilgili coğrafi bilgiler içerir.

Alanlar
place

string

v4alpha/v4beta kullanıcıları için işlem yapılması gerekiyor: Bu alan yakında eski biçim olan "//places.googleapis.com/places/{placeID}" yerine yeni biçim olan "places/{placeId}" olarak güncellenecek. Uygulamanızın geçiş döneminde her iki biçimi de işleyebildiğinden emin olun. Eski biçimin, Mayıs 2026'nın sonlarına kadar tamamen kullanımdan kaldırılması bekleniyor.

Bu sonuç için tam nitelikli yer tanımlayıcısı. "//places.googleapis.com/places/{placeID}" biçiminde. Daha fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/place-id adresini ziyaret edin.
place_id

string

Bir yerin benzersiz tanımlayıcısı.
location

LatLng

Bu adresin enlem ve boylamı.
granularity

GeocodeResult.Granularity

Konumun ayrıntı düzeyi.
viewport

Viewport

Coğrafi kod sonucu görüntülemeye uygun bir görünüm alanı.
bounds

Viewport

Adres için sınırlayıcı bir kutu.
formatted_address

string

Tek satırda biçimlendirilmiş adres.
postal_address

PostalAddress

Posta adresi biçimindeki adres.
address_components[]

GeocodeResult.AddressComponent

Her yerleşim birimi seviyesi için tekrarlanan bileşenler.
postal_code_localities[]

LocalizedText

Posta kodunda yer alan tüm yerleşim yerlerinin tam listesi.

Bu alan yalnızca sonuç "postal_code" türündeyse doldurulur.
types[]

string

Bu sonuç için bir dizi tür etiketi. Örneğin, "political" ve "administrative_area".

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

PlusCode

Bu coğrafi kodda yer alan konumun Plus Code'u.

AddressComponent

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

Alanlar
long_text

string

Adres bileşeninin tam metin açıklaması veya adı. Örneğin, Avustralya ülkesine ait bir adres bileşeninin uzun adı "Avustralya" olabilir.
short_text

string

Varsa adres bileşeninin kısaltılmış metin adı. Örneğin, Avustralya ülkesinin bir adres bileşeninin kısa adı "AU" olabilir.
types[]

string

Adres bileşeninin türlerini belirten bir dizi.

Daha fazla bilgi için https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types adresini ziyaret edin.
language_code

string

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

Ayrıntı düzeyi

Konumun ayrıntı düzeyi.

Sıralamalar
GRANULARITY_UNSPECIFIED Kullanmayın.
ROOFTOP Eşleşen adrese karşılık gelen gerçek bir arazi parçasının enterpolasyon yapılmamış konumu.
RANGE_INTERPOLATED Bir dizi sokak numarası arasında enterpolasyon yapılmıştır. Örneğin, Amphitheatre Pkwy'nin bir bölümünün 1600-1699 numaralarını içerdiğini biliyorsak 1650 numarası, uç noktalarının ortasına yerleştirilebilir.
GEOMETRIC_CENTER Çokgen verilerimizin bulunduğu bir özelliğin geometrik merkezi.
APPROXIMATE Diğer her şey.

ImageAnnotation

Bir resim küçük resmindeki açıklama (ör. bir girişi çevreleyen çokgen).

Alanlar
coordinates[]

ImageAnnotation.Coordinate

Resimde bir poligon oluşturan koordinatların listesi. Koordinatlar saat yönünün tersine sıralanır.

Koordinat

Resimdeki bir noktanın piksel koordinatı. Başlangıç noktası (0,0), resmin sol üst pikselinin sol üst köşesidir. X ekseni sağa, Y ekseni ise aşağıyı gösterir.

Alanlar
x_px

float

X koordinatı.
y_px

float

Y koordinatı.

Önemli nokta

Önemli noktalar, varış noktasının nerede olduğunu bildirmek veya varış noktasına ulaşmaya yardımcı olmak için kullanılır.

Alanlar
relational_description

LocalizedText

Hedefin, önemli yerle ilişkisini açıklayan, kullanıcıların okuyabileceği bir açıklama. Örneğin: "Empire State Binası'nın yakınında" veya "Beyaz Saray'ın karşısında".
tags[]

Landmark.Tag

Önemli yerin hedef bağlamında nasıl kullanılabileceğini açıklayan etiketler.
straight_line_distance_meters

double

Yalnızca çıkış. Bu önemli noktadan hedefe olan düz çizgi mesafesi (metre).
travel_distance_meters

double

Yalnızca çıkış. Bu simge yapıdan varış noktasına olan yol ağı mesafesi (metre).
landmark birleşik alanı. Önemli nokta. landmark aşağıdakilerden yalnızca biri olabilir:
place

PlaceView

Bu simge yapıyı temsil eden yer.

Etiket

Bir yer işaretinin hedef bağlamında nasıl kullanılabileceğini açıklayan tüm olası etiketlerin listesi.

Bir adreste hem ADDRESS hem de ARRIVAL etiketi varsa önemli nokta hem yerel olarak öne çıkıyor hem de hedefe yakın demektir.

Sıralamalar
TAG_UNSPECIFIED Kullanılmıyor.
ADDRESS Hedefin yaklaşık konumunu belirlemek için kullanılabilecek, yerel olarak öne çıkan bir yer. Genellikle varış noktasının birkaç yüz metre yakınında. Bunlar, Geocoding API'nin Adres Tanımlayıcıları özelliği tarafından döndürülen önemli yerlere benzer: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL Hedefe ulaşmaya yardımcı olmak için kullanılabilen bir yer. Hedefe yaklaştığınızda gezinme için kullanışlıdır. Örneğin, bu önemli yer, hedefin bulunduğu sokağın karşısında olabilir. Bu etikete sahip bir önemli nokta, genellikle hedefe ADDRESS etiketine sahip önemli noktalardan daha yakındır.

Navigasyon noktası, navigasyonun sona erebileceği bir yolun yanındaki konumdur.

Alanlar
navigation_point_token

string

Yalnızca çıkış. Bu gezinme noktasını tanımlamak için kullanılabilecek bir jeton.
display_name

LocalizedText

Bu gezinme noktasının görünen adı. Örneğin, "5th Ave" veya "Gate B".
location

LatLng

Navigasyonun sona ermesi gereken yol segmentinin yanındaki bir nokta. Nokta, yerin bulunduğu yol tarafını net bir şekilde işaretlemek için yolun merkez çizgisinden kasıtlı olarak biraz uzağa yerleştirilir.
travel_modes[]

NavigationPoint.TravelMode

Bu gezinme noktası için uygun olan seyahat modları.
usages[]

NavigationPoint.Usage

Bu navigasyon noktası tarafından desteklenen usages listeleri. Boş olması, kullanımının herhangi bir şekilde kısıtlandığı anlamına gelmez. Tüm gezinme noktaları genel gezinme için kullanılabilir.
street_view_thumbnail

StreetViewThumbnail

Varsa gezinme noktasını gösteren Street View küçük resmi. Görüntü, Street View Static API'den istenebilir. https://developers.google.com/maps/documentation/streetview/request-streetview adresini ziyaret edin.
entrance_annotation

ImageAnnotation

Varsa yukarıda döndürülen street_view_thumbnail üzerinde bu gezinme noktasıyla ilişkili girişin açıklaması.
altitude_meters

float

WGS-84 elipsoidine göre navigasyon noktasının metre cinsinden yüksekliği.

TravelMode

Bu gezinme noktası için uygun olan seyahat modları.

Sıralamalar
TRAVEL_MODE_UNSPECIFIED Kullanılmıyor.
DRIVE Sürüş için uygundur.
WALK Yürüyüş için uygundur.

Kullanım

Bu gezinme noktası tarafından desteklenen kullanımlar. Gelecekte yeni değerler eklenebilir.

Sıralamalar
USAGE_UNSPECIFIED Kullanılmıyor.
UNKNOWN Kullanım türünün bilinmediğini gösterir.
DROPOFF Yolcu bırakmak için uygundur. Örneğin, paylaşımlı araçla bırakma konumu.
PICKUP Yolcu almak için uygundur. Örneğin, paylaşımlı araçların yolcu aldığı yerler.
PARKING Park etmeye uygundur. Örneğin, bir otoparkta.

PlaceView

Places API'deki bir Place görünümünü temsil eder. Ayrıca, hedefle ilgili ek bilgiler (ör. yapı türü ve görüntüleme çokgeni) de sağlar.

Bazı durumlarda, aynı yer kimliğine sahip bir PlaceView, types ve display_name alanları için Places API tarafından döndürülenlerden farklı olabilir.

Alanlar
place

string

v4alpha/v4beta kullanıcıları için işlem yapılması gerekiyor: Bu alan yakında eski biçim olan "//places.googleapis.com/places/{placeID}" yerine yeni biçim olan "places/{placeId}" olarak güncellenecek. Uygulamanızın geçiş döneminde her iki biçimi de işleyebildiğinden emin olun. Eski biçimin, Mayıs 2026'nın sonlarına kadar tamamen kullanımdan kaldırılması bekleniyor.

Bu sonuç için tam nitelikli yer tanımlayıcısı. "//places.googleapis.com/places/{placeID}" biçiminde. Daha fazla bilgi için https://developers.google.com/maps/documentation/places/web-service/place-id adresini ziyaret edin.
place_id

string

Bir yerin benzersiz tanımlayıcısı.
display_name

LocalizedText

Kullanıcılar tarafından okunabilir yer açıklaması. Örneğin, "B Kapısı", "McDonalds"
primary_type

string

Bu yerin birincil yer türü. Olası değerlerin listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresini ziyaret edin.

Not: Bu alan her zaman doldurulmaz. Bu tür durumlarda types alanını kullanmaya hazır olun.
types[]

string

Bu yerle ilişkili tüm yer türleri. Olası değerlerin listesi için https://developers.google.com/maps/documentation/places/web-service/place-types adresini ziyaret edin.
formatted_address

string

Tek satırlık adres.
postal_address

PostalAddress

Yapılandırılmış adres.
structure_type

PlaceView.StructureType

Bu yere karşılık gelen yapı türü.
location

LatLng

Bu yerin konumu. Görüntü poligonları olan yerler için bu, haritaya işaretçi yerleştirmek için iyi bir nokta olabilir.
display_polygon

Struct

RFC 7946 biçimini kullanarak GeoJSON biçimindeki yerin poligon ana hattı: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Not: RFC 7946 biçimi MultiPolygon'ları desteklediğinden bir display_polygon nesnesi birden fazla poligonu temsil edebilir.
address_components[]

PlaceView.AddressComponent

Her yerleşim birimi seviyesi için tekrarlanan bileşenler.

AddressComponent

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

Alanlar
long_text

string

Adres bileşeninin tam metin açıklaması veya adı. Örneğin, Avustralya ülkesine ait bir adres bileşeninin uzun adı "Avustralya" olabilir.
short_text

string

Varsa adres bileşeninin kısaltılmış metin adı. Örneğin, Avustralya ülkesinin bir adres bileşeninin kısa adı "AU" olabilir.
types[]

string

Adres bileşeninin türlerini belirten bir dizi.

Daha fazla bilgi için /maps/documentation/geocoding/requests-geocoding#Types adresini ziyaret edin.
language_code

string

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

StructureType

Bu yerin temsil ettiği yapı türü.

Sıralamalar
STRUCTURE_TYPE_UNSPECIFIED Kullanılmıyor.
POINT Nokta konumu.
SECTION Bir binanın alt bölümü.
BUILDING Bir bina.
GROUNDS Genellikle üniversite kampüsü, apartman kompleksi veya alışveriş merkezi gibi birden fazla binanın bulunduğu geniş bir alan.

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 metreye 14 metre) alanı temsil eden yerin global (tam) kodu.
compound_code

string

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

SearchDestinationsRequest

DestinationService.SearchDestinations için istek mesajı.

Alanlar
travel_modes[]

NavigationPoint.TravelMode

İsteğe bağlı. Gezinme noktalarını filtrelemek için kullanılan ulaşım şekilleri. Bu, yanıtta döndürülen navigation_points alanını etkiler. Boşsa tüm ulaşım şekillerinin gezinme noktaları döndürülür.
language_code

string

İsteğe bağlı. Sonuçların döndürülmesi gereken dil.
region_code

string

İsteğe bağlı. Bölge kodu. Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen iki karakterli bir değerdir. Parametre, geçerli yasaya göre sonuçları etkiler. Bu parametre, hizmetten gelen sonuçları da etkiler ancak tamamen kısıtlamaz.

primary_query birleşik alanı. Birincil hedef için sorgu. Bu, bir yer, tam olarak belirtilmiş bir adres veya bir LatLng konumu olabilir. En az bilgiye sahip bazı yerler ve adresler hedef olarak kullanılamaz.

Hedefler, belirtilen birincil sorgu etrafında oluşturulur.

Not: Yalnızca navigasyon hedefi olabilecek yerler ve adresler desteklenir. Örneğin, bir evi veya apartman kompleksini temsil eden bir yer birincil sorgu olarak kullanılabilir ancak bir yerleşim yerini veya idari bölgeyi temsil eden yerler birincil sorgu olarak kullanılamaz. primary_query aşağıdakilerden yalnızca biri olabilir:
place

string

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

SearchDestinationsRequest.AddressQuery

Açık adrestir.
location_query

SearchDestinationsRequest.LocationQuery

Tam konum

AddressQuery

Aramak istediğiniz açık adres. Adresleri, ilgili ülkenin ulusal posta hizmetinin kullandığı biçime uygun olarak belirtin.

Alanlar
kind birleşik alanı. Adres sorgusu. kind aşağıdakilerden yalnızca biri olabilir:
address

PostalAddress

Posta adresi biçiminde bir açık adres.
address_query

string

Tek satır olarak biçimlendirilmiş bir açık adres.

LocationQuery

Yakındaki birincil hedefi belirlemek için konum sorgusu.

Not: Konum sorgusu, alt tesisler içeren bir binadaysa döndürülen birincil yerin alt tesis olması mümkündür. Bu durumlarda containing_places alanına bina dahil edilir.

Alanlar
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

İsteğe bağlı. Hedef adaylara uygulanacak filtreler.
kind birleşik alanı. Konum sorgusu. kind aşağıdakilerden yalnızca biri olabilir:
location

LatLng

Tam bir LatLng konumu.

PlaceFilter

Hedef adaylara uygulanacak filtreler.

Alanlar
structure_type

PlaceView.StructureType

İsteğe bağlı. Belirtilmişse tüm hedeflerin bu yapı türünde birincil bir yeri olduğu garanti edilir. Bu durum, bazı hedeflerin filtrelenmesine veya döndürülen hedeflerin kabalaştırılmasına/iyileştirilmesine neden olabilir.

Örneğin, GROUNDS belirtilirse döndürülen tüm hedeflerin GROUNDS yapı türünde birincil yeri olur. Bu durum, bir kampüsün parçası olmayan bazı hedeflerin filtrelenmesine veya döndürülen hedeflerin kampüs düzeyine indirgenmesine neden olabilir.

Bu alanın bir diğer kullanım alanı da bina görüntüleme poligonlarını daha kolay bir şekilde çıkarmaktır. Örneğin, BUILDING belirtilirse birincil yerin görüntüleme poligonu, belirtilen konumdaki bina için olur.
addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

İsteğe bağlı. Belirtilirse yalnızca ilgili adreslenebilirlik ölçütlerini karşılayan hedefleri döndürür.

Adreslenebilirlik

Adreslenebilirlik filtreleme seçeneklerini tanımlar. Gelecekte yeni değerler eklenebilir.

Sıralamalar
ADDRESSABILITY_UNSPECIFIED Belirtilmediğinde hizmet, makul bir varsayılan değer seçer.
ANY Adreslenebilirlik bir filtreleme ölçütü değildir. Hedefler, adreslenebilirliklerinden bağımsız olarak döndürülür.
PRIMARY Döndürülen tüm hedeflerde sokak düzeyinde adresi veya adı olan birincil bir yer bulunur.
WEAK Döndürülen tüm hedefler, birincil bir yere veya sokak düzeyinde adresi ya da adı olan bir alt hedefe sahip olur.

SearchDestinationsResponse

DestinationService.SearchDestinations için yanıt mesajı.

Alanlar
destinations[]

Destination

Hedeflerin listesi.

Birincil sorgudan birincil hedef net bir şekilde tanımlanabiliyorsa hizmet tek bir sonuç döndürür. Aksi takdirde, hizmet belirsizliği gidermek için birden fazla sonuç veya hiç sonuç döndürmeyebilir.

StreetViewThumbnail

Google Street View küçük resmini temsil etme parametreleri. Bu parametreler, Street View Static API'den bir Street View görüntüsü istemek için kullanılabilir. https://developers.google.com/maps/documentation/streetview/request-streetview adresini ziyaret edin.

Alanlar
pano

string

Belirli bir panorama kimliği.
width_px

int32

Çıkış küçük resim görüntüsünün piksel cinsinden genişliği. Not: Küçük resimle birlikte ek açıklamalar istenirken, ek açıklama koordinatlarının resimle doğru şekilde hizalanması için bu yükseklik ve genişlik değerlerinin Street View API isteğinde kullanılması gerekir.
height_px

int32

Çıkış küçük resim görüntüsünün piksel cinsinden yüksekliği. Not: Küçük resimle birlikte ek açıklamalar istenirken, ek açıklama koordinatlarının resimle doğru şekilde hizalanması için bu yükseklik ve genişlik değerlerinin Street View API isteğinde kullanılması gerekir.
heading_degree

float

Kameranın derece cinsinden yatay yönü. Aralık [0, 360). 0 değeri Kuzey, 90 değeri ise Doğu yönünü belirtir.
pitch_degree

float

Kameranın derece cinsinden dikey yönü. Aralık [-90, 90]. 0 değeri ufuk çizgisini, +90 değeri dimdik yukarıyı, -90 değeri ise dimdik aşağıyı gösterir.
fov_degree

float

Derece cinsinden yatay görüş alanı. Aralık (0, 180]. Yakınlaştırma seviyesini kontrol eder. Daha küçük bir FOV, daha fazla yakınlaştırma anlamına gelir.