Package google.maps.geocode.v4alpha

Dizin

DestinationService

Hedefleri almak için kullanılan bir hizmet.

Hedef, bir yerle ilgili hiyerarşik bağlam sağlar. Bu sayede, örneğin daha büyük bir apartman kompleksindeki apartman binalarını ve bunun 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

Hedef

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

Alanlar
primary

PlaceView

İstekteki 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: Places API tarafından döndürülen SubDestination ile karşılaştırıldığında, bu alt hedefler listesi 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 hedef için navigasyon noktaları.

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.

Etiket

Bir girişi tanımlayan özellikler.

Sıralamalar
TAG_UNSPECIFIED Kullanılmaz.
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şte bu etiket yoksa girişin fiziksel olarak birincil yerle aynı binada olduğu ancak yere erişim sağlamayabileceği anlamına gelir.

Örneğin, birincil yer bir alışveriş merkezindeki bir restoransa "TERCİH EDİLEN" girişler muhtemelen 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şler, binanın "ana" kısmına giden girişler olur. Örneğin, bir alışveriş merkezinde PREFERRED girişler, ana fuaye alanına erişime izin veren girişlerdir. Ancak bir giriş yalnızca binanın yan tarafındaki bir mağazaya erişim sağlıyorsa PREFERRED giriş olmaz.

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

Önemli nokta

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

Alanlar
tags[]

Landmark.Tag

Önemli yerin hedef bağlamında nasıl kullanılabileceğini açıklayan etiketler.
Birleştirme alanı landmark. Önemli nokta. landmark yalnızca aşağıdakilerden 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 bu yer işareti hem yerel olarak öne çıkıyor hem de hedefe yakın demektir.

Sıralamalar
TAG_UNSPECIFIED Kullanılmaz.
ADDRESS Hedefin genel 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, varış noktasının karşısında olabilir. Bu etikete sahip bir yer işareti genellikle hedefe, ADDRESS etiketine sahip yer işaretlerinden daha yakındır.

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

Alanlar
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 seyahat modları.
usages[]

NavigationPoint.Usage

Bu gezinme noktası tarafından desteklenen kullanımlar.

TravelMode

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

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

Kullanım

Bu gezinme noktası tarafından desteklenen kullanımlar.

Sıralamalar
USAGE_UNSPECIFIED Kullanılmaz.
UNKNOWN Bilinmeyen kullanım türü. Çoğu gezinme noktası UNKNOWN olarak gösterilir. Bu, kullanımının herhangi bir şekilde kısıtlandığı anlamına gelmez. Bu rota, teslim alma ve/veya bırakma için uygun olabilir.
DROPOFF Yolcu bırakmak için uygundur. Örneğin, bir araç paylaşımı bırakma konumu.
PICKUP Yolcu almak için uygundur. Örneğin, paylaşımlı araçların yolcu aldığı yerler.

PlaceView

Places API'deki bir yerin görünümünü temsil eder. Ayrıca, hedefle ilgili yapı türü ve görüntüleme poligonu gibi 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ülenlerden farklı olabilir.

Alanlar
place

string

Bu yerin places/{placeId} biçimindeki kaynak adı.
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 yerin 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.

StructureType

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

Sıralamalar
STRUCTURE_TYPE_UNSPECIFIED Kullanılmaz.
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.

SearchDestinationsRequest

DestinationService.SearchDestinations için istek mesajı.

Alanlar
travel_modes[]

NavigationPoint.TravelMode

İsteğe bağlıdır. 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ülebilir.
language_code

string

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

string

İsteğe bağlıdır. Bölge kodu. Bölge kodu, ccTLD ("üst düzey alan") olarak belirtilen iki karakterlik 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.

Birleştirme alanı primary_query. 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 gezinme 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 birimini veya idari bölgeyi temsil eden yerler birincil sorgu olarak kullanılamaz. primary_query yalnızca aşağıdakilerden 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
Birleştirme alanı kind. Adres sorgusu. kind yalnızca aşağıdakilerden biri olabilir:
address

PostalAddress

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

string

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

LocationQuery

Yakındaki bir 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ı binayı içerir.

Alanlar
Birleştirme alanı kind. Konum sorgusu. kind yalnızca aşağıdakilerden biri olabilir:
location

LatLng

Tam bir LatLng konumu.

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.