Package google.maps.geocode.v4alpha

Dizin

DestinationService

Hedefleri alma hizmeti.

Varış noktası, bir yer hakkında hiyerarşik bağlam sağlar. Bu sayede, örneğin daha büyük bir apartman kompleksi içindeki 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 araması 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ştirmek için kullanılan bir hizmet.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse)

Bu yöntem, bir adresi LatLng ile eşleyen bir adres coğrafi kodu oluşturur. Ayrıca adresle ilgili 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 bir adresle eşleyen bir konum coğrafi kodu oluşturur. Ayrıca adresle ilgili 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öntem, yer kimliği kullanarak coğrafi kod araması yapar.

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

Hedef. Buna birincil yer, ilgili yerler, girişler ve navigasyon noktaları dahildir.

Alanlar
primary

PlaceView

İstekteki primary_query ile tanımlanan birincil yer.
containing_places[]

PlaceView

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

PlaceView

Birincil yerin daha hassas alt varış noktaları. Örneğin, bir binadaki birimler.

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

Landmark

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

Entrance

Bu hedefin girişleri.
navigation_points[]

NavigationPoint

Bu hedefin gezinme noktaları.
parking_options

Destination.ParkingOptions

Bu hedef için park yeri seçenekleri.
arrival_summary

Destination.ArrivalSummary

Varış noktasındaki varış deneyiminin yapay zeka tarafından üretilmiş özeti.

ArrivalSummary

Varış noktasındaki varış deneyiminin yapay zeka tarafından üretilmiş özeti.

Alanlar
text

LocalizedText

Varış noktasındaki varış deneyiminin özeti.
flag_content_url

string

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

LocalizedText

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

ParkingOptions

Hedefteki park seçenekleri hakkında bilgi.

Alanlar
availability

Destination.ParkingOptions.Availability

Bu hedefte otopark olup olmadığı.
parking_facilities[]

Destination.ParkingOptions.ParkingFacility

Bu hedefteki otopark olanakları.
onsite_parking

bool

Varış noktasında otopark vardır.
free_parking_lot

bool

Ücretsiz otopark hizmeti sunulur.
paid_parking_lot

bool

Ücretli otoparklar sunar.
free_street_parking

bool

Cadde üzerinde ücretsiz park yeri sunulur.
paid_street_parking

bool

Cadde üzerinde ücretli park yeri sunar.
valet_parking

bool

Vale park hizmeti sunulur.
free_garage_parking

bool

Ücretsiz kapalı otoparkı vardır.
paid_garage_parking

bool

Ücretli kapalı otoparkı var.

Kullanılabilirlik

Bu yeri ziyaret ederken park yeri bulmanın ne kadar zor olduğunu gösteren toplu ölçüm.

Gelecekte yeni değerler eklenebilir.

Sıralamalar
AVAILABILITY_UNSPECIFIED Otopark uygunluğu bilgisi mevcut değil.
PLENTY Yeterli park yeri var.
SOMEWHAT_DIFFICULT Park yeri bulmak biraz zor.
DIFFICULT Park yeri bulmak çok zor.

ParkingFacility

Hedefle ilişkili ayrı bir park seçeneği (ör. belirli bir otopark veya park alanı). Bu mesaj, belirli bir otopark tesisi hakkında ayrıntılı bilgi sağlarken üst ParkingOptions mesajı, mevcut tüm otoparkların toplu bir özetini sunar.

Alanlar
place

PlaceView

Bu otopark tesisinin yer temsili.
onsite

bool

Bu otopark tesisinin birincil varış noktasında bulunup bulunmadığı bilgisi. Bu alan ayarlanmazsa yerinde çalışma durumu bilinmez.
popular

bool

Bu otoparkın, birincil varış noktasına seyahat eden ziyaretçiler için popüler bir seçenek olup olmadığı. Bu alan ayarlanmazsa popülerlik durumu bilinmez.
straight_line_distance_meters

double

Birincil varış noktasından bu otopark tesisine olan kuş uçuşu mesafe (metre cinsinden).

Giriş

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

Alanlar
display_name

LocalizedText

İnsanlar tarafından okunabilir ad (ör. "B Kapısı", "Güney Girişi", "5. Cadde Girişi").
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 ek 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ş bu etikete sahip değilse giriş, fiziksel olarak birincil yerle aynı binada yer alıyor ancak yere erişim sağlamıyor demektir.

Örneğin, birincil yer bir alışveriş merkezindeki restoransa "TERCİH EDİLEN" girişler, muhtemelen restoranın kendisine açılan 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 yer bir binaysa PREFERRED girişleri, binanın "ana" bölümüne açılan girişler olur. Örneğin, bir alışveriş merkezinde PREFERRED girişleri, ana fuaye alanına erişim sağlayan girişler olacaktır. Ancak bir giriş yalnızca binanın yan tarafındaki bir mağazaya erişim sağlıyorsa PREFERRED girişi olmayacaktır.

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

GeocodeAddressRequest

GeocodeService.GeocodeAddress için istek mesajı.

Alanlar
location_bias

GeocodeAddressRequest.LocationBias

İsteğe bağlıdır. Aranacak bölge. Bu konum, bir önyargı görevi görür. Yani, belirtilen konumun etrafındaki sonuçlar tercih edilir.
language_code

string

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

string

İsteğe bağlıdır. Bölge kodu. ccTLD ("üst düzey alan") iki karakterli değeri olarak belirtilen bölge kodu. Parametre, geçerli yasaya göre sonuçları etkiler. Bu parametre, hizmetten gelen sonuçları da etkiler ancak tamamen kısıtlamaz.
address_input birleşik alanı. Coğrafi kodu belirlenecek 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 kodlanacak yapılandırılmış adres.

LocationBias

Aranacak bölge. Bu konum, bir önyargı görevi görür. Yani, belirtilen konumun etrafındaki sonuçlar tercih edilir.

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 bir kutu. rectangle.high(), dikdörtgen görüntü alanının kuzeydoğu noktası olmalıdır. rectangle.low(), dikdörtgen görüntü alanının güneybatı noktası olmalıdır. rectangle.low().latitude(), rectangle.high().latitude() değerinden büyük olamaz. Bu 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ıdır. Sonuçların döndürüleceği dil.
region_code

string

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

string

İsteğe bağlıdır. Sonuçları kısıtlamak için bir tür etiketi 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 Tablo A ve Tablo B'ye bakın.
granularity[]

GeocodeResult.Granularity

İsteğe bağlıdır. Bir veya daha fazla konum ayrıntı düzeyi enum'u içeren bir filtre.
location_input birleşik alanı. Coğrafi kodu belirlenecek 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. places/{place} biçiminde coğrafi kodlanacak yer tanımlayıcısı.
language_code

string

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

string

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

GeocodeResult

Coğrafi kod sonucu, bir yerle ilgili coğrafi bilgileri içerir.

Alanlar
place

string

Bu yerin places/{placeId} biçimindeki kaynak adı. Yeri aramak için kullanılabilir.
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 sonucunu görüntülemeye uygun bir görüntü alanı.
bounds

Viewport

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

string

Tek satırlık biçimlendirilmiş adres.
postal_address

PostalAddress

Posta adresi biçimindeki adres.
address_components[]

GeocodeResult.AddressComponent

Her yerleşim düzeyi için tekrarlanan bileşenler.
postal_code_localities[]

LocalizedText

Posta kodunda yer alan yerleşim yerlerinin tam listesi.

Bu alan yalnızca sonuç "postal_code" türünde olduğunda doldurulur.
types[]

string

Bu sonuç için bir tür etiketi grubu. Ö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 Tablo A ve Tablo B'ye bakın.
plus_code

PlusCode

Bu coğrafi koddaki konumun Plus Code'u.

AddressComponent

Bu bilgi mevcutsa biçimlendirilmiş adresi oluşturan yapılandırılmış bileşenler.

Alanlar
long_text

string

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

string

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

string

Adres bileşeninin türlerini belirten bir dizi.

Bu değerler, Places API tarafından kullanılan adres türleri ve adres bileşeni türleri tablosundan alınır: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

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

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 arsanın enterpolasyonlu olmayan konumu.
RANGE_INTERPOLATED Bir sokak numarası aralığından tahmin edilmiştir. Örneğin, Amphitheatre Pkwy'nin bir segmentinin 1600-1699 numaralarını içerdiğini biliyorsak 1650, uç noktalarının ortasına yerleştirilebilir.
GEOMETRIC_CENTER Çokgen verilerine sahip olduğumuz bir özelliğin geometrik merkezi.
APPROXIMATE Diğer her şey.

ImageAnnotation

Görsel küçük resmindeki bir ek açıklama (ör. girişi çevreleyen bir çokgen).

Alanlar
coordinates[]

ImageAnnotation.Coordinate

Resim üzerinde 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ğıya doğru ilerler.

Alanlar
x_px

float

X koordinatı.
y_px

float

Y koordinatı.

Önemli nokta

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

Alanlar
relational_description

LocalizedText

Hedefin önemli yerle ilişkisinin kullanıcılar tarafından okunabilir açıklaması. Örneğin: "Empire State Binası'nın yakınında" veya "Beyaz Saray'ın karşısında".
tags[]

Landmark.Tag

Önemli yerin varış noktası 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 cinsinden).
travel_distance_meters

double

Yalnızca çıkış. Bu önemli noktadan varış noktasına olan yürüme mesafesi (metre cinsinden).
landmark birleşik alanı. Önemli nokta. landmark aşağıdakilerden yalnızca biri olabilir:
place

PlaceView

Bu önemli yeri temsil eden yer.

Etiket

Bir önemli noktanın varış noktası 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 hedefe birkaç yüz metre mesafede. 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ılabilecek bir yer. Hedefe yaklaştığınızda navigasyon için kullanışlıdır. Örneğin, bu önemli nokta, varış noktasının karşısındaki bir yer olabilir. Bu etikete sahip bir önemli nokta, genellikle ADDRESS etiketine sahip önemli noktalara kıyasla hedefe daha yakındır.

Navigasyon noktası, bir yolun yanında navigasyonun sona erebileceği bir 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, "5. Cadde" veya "B Kapısı".
location

LatLng

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

NavigationPoint.TravelMode

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

NavigationPoint.Usage

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

StreetViewThumbnail

Varsa, navigasyon 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 ek açıklaması.
altitude_meters

float

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

TravelMode

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

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

Kullanım

Bu navigasyon 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 indirmek için uygundur. Örneğin, araç paylaşımı bırakma konumu.
PICKUP Yolcu almak için uygundur. Örneğin, araç paylaşımı için yolcu alma konumu.
PARKING Park etmeye uygundur. Örneğin, bir otoparkın içinde.

PlaceView

Places API'deki bir Place görünümünü temsil eder. Ayrıca, yapı türü ve görüntüleme poligonu gibi hedeflere özgü ek bilgiler 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ülen değerden farklı olabilir.

Alanlar
place

string

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

string

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

LocalizedText

İnsan tarafından okunabilen 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. Poligonların gösterildiği yerlerde bu, haritaya işaretçi yerleştirmek için iyi bir nokta olabilir.
display_polygon

Struct

RFC 7946 biçimi kullanılarak GeoJSON biçiminde yerin poligon konturu: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Not: RFC 7946 biçimi MultiPolygon'ları destekler. Bu nedenle, bir display_polygon nesnesi birden fazla poligonu temsil edebilir.
address_components[]

PlaceView.AddressComponent

Her yerleşim düzeyi için tekrarlanan bileşenler.

AddressComponent

Bu bilgi mevcutsa biçimlendirilmiş adresi oluşturan yapılandırılmış bileşenler.

Alanlar
long_text

string

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

string

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

string

Adres bileşeninin türlerini belirten bir dizi.

Bu değerler, Places API tarafından kullanılan adres türleri ve adres bileşeni türleri tablosundan alınır: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types
language_code

string

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

StructureType

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

Sıralamalar
STRUCTURE_TYPE_UNSPECIFIED Kullanılmıyor.
POINT Nokta konum.
SECTION Bir binanın alt bölümü.
BUILDING Bina
GROUNDS Genellikle üniversite kampüsü, apartman kompleksi veya alışveriş merkezi gibi birden fazla bina içeren büyük bir alan.

PlusCode

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

Alanlar
global_code

string

Yerin 1/8.000'e 1/8.000 derecelik bir alanı (~14 x 14 metre) temsil eden "9FWM33GV+HQ" gibi global (tam) kodu.
compound_code

string

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

SearchDestinationsRequest

DestinationService.SearchDestinations için istek mesajı.

Alanlar
travel_modes[]

NavigationPoint.TravelMode

İsteğe bağlıdır. Navigasyon noktalarının filtreleneceği seyahat modları. Bu, yanıtta döndürülen navigation_points alanını etkiler. Boş bırakılırsa tüm seyahat modlarının navigasyon noktaları döndürülür.
language_code

string

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

string

İsteğe bağlıdır. Bölge kodu. ccTLD ("üst düzey alan") iki karakterli değeri olarak belirtilen bölge kodu. 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 LatLng konumu olabilir. Çok az bilgi içeren bazı yerler ve adresler varış noktasına dönüştürülemez.

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 bölgeyi veya idari alanı 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 hizmeti tarafından kullanılan 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ş açık adres.

LocationQuery

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

Not: Konum sorgusu, alt tesisler içeren bir binanın içindeyse döndürülen birincil yer bir alt tesis olabilir. Bu gibi durumlarda containing_places alanı binayı içerir.

Alanlar
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

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

LatLng

Tam LatLng konumu.

PlaceFilter

Hedef adaylarına uygulanacak filtreler.

Alanlar
structure_type

PlaceView.StructureType

İsteğe bağlıdır. Belirtilirse tüm hedeflerin bu yapı türüne sahip birincil bir yere sahip olması garanti edilir. Bu durum, bazı varış noktalarının filtrelenmesine veya döndürülen varış noktalarının kabalaştırılmasına/hassaslaştırılmasına neden olabilir.

Örneğin, GROUNDS belirtilirse döndürülen tüm varış noktalarının GROUNDS yapı türüne sahip bir birincil yeri olur. Bu durum, bir tesisin parçası olmayan bazı varış noktalarının filtrelenmesine veya döndürülen varış noktalarının tesis düzeyine kabalaştırılmasına neden olabilir.

Bu alanın bir başka kullanım amacı da bina görüntüleme poligonlarını daha kolay ayıklamaktı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ıdır. 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, adreslenebilirlik durumlarına bakılmaksızın döndürülür.
PRIMARY Döndürülen tüm varış noktalarında, sokak düzeyinde adresi veya adı olan bir birincil yer bulunur.
WEAK Döndürülen tüm varış noktalarında birincil bir yer veya sokak düzeyinde adresi ya da adı olan bir alt varış noktası bulunur.

SearchDestinationsResponse

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

Alanlar
destinations[]

Destination

Hedeflerin listesi.

Birincil sorgudan birincil hedef net bir şekilde belirlenebiliyorsa hizmet bir sonuç döndürür. Aksi takdirde hizmet, anlam belirsizliğini giderme için birden fazla sonuç veya sıfır sonuç döndürebilir.

StreetViewThumbnail

Google Street View küçük resmini temsil eden parametreler. 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 resminin piksel cinsinden genişliği. Not: Küçük resimle birlikte ek açıklama istenirken ek açıklama koordinatlarının resimle doğru şekilde hizalanması için Street View API isteğinde bu yükseklik ve genişlik değerleri kullanılmalıdır.
height_px

int32

Çıkış küçük resminin piksel cinsinden yüksekliği. Not: Küçük resimle birlikte ek açıklama istenirken ek açıklama koordinatlarının resimle doğru şekilde hizalanması için Street View API isteğinde bu yükseklik ve genişlik değerleri kullanılmalıdır.
heading_degree

float

Kameranın derece cinsinden yatay yönü. Aralık [0, 360). 0, kuzeyi, 90 ise doğuyu gösterir.
pitch_degree

float

Kameranın derece cinsinden dikey yönü. [-90, 90] aralığı. 0 ufuk çizgisini, +90 tam yukarıyı, -90 ise tam 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 FOV, daha fazla yakınlaştırma anlamına gelir.