Package google.maps.geocode.v4

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 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ş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 adrese 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 navigasyon 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ına 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 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ş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.

GeocodeAddressRequest

GeocodeService.GeocodeAddress için istek mesajı.

Alanlar
location_bias

GeocodeAddressRequest.LocationBias

İsteğe bağlı. Aranacak 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. ccTLD ("üst düzey alan") olarak belirtilen, iki karakterli bir değer olan 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 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 kodu belirlenecek yapılandırılmış adres.

LocationBias

Aranacak 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öş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.

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. ccTLD ("üst düzey alan") olarak belirtilen, iki karakterli bir değer olan bölge kodu. 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. ccTLD ("üst düzey alan") olarak belirtilen, iki karakterli bir değer olan bölge kodu. Parametre, geçerli yasaya göre sonuçları etkiler.

GeocodeResult

Coğrafi kod sonucu, bir yerle ilgili coğrafi bilgiler 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ünüm alanı.
bounds

Viewport

Adres için bir sınırlandırıcı 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ından tahmin edilmiştir. Ö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 Poligonal verilerimizin bulunduğu bir özelliğin geometrik merkezi.
APPROXIMATE Diğer her şey.

Ö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 simge yapıyla 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 noktanın 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 kuş uçuşu mesafe (metre).
travel_distance_meters

double

Yalnızca çıkış. Bu önemli noktadan 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 önemli noktayı temsil eden yer.

Etiket

Bir önemli noktanın 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 önemli nokta hem yerel olarak öne çıkıyor hem de hedefe yakın demektir.

Sıralamalar
TAG_UNSPECIFIED Kullanılmaz.
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 nokta, 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 kasıtlı olarak yolun merkez çizgisinden 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 usages listelenir. 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.

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

Kullanım

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

Sıralamalar
USAGE_UNSPECIFIED Kullanılmaz.
UNKNOWN Kullanım türünün bilinmediğini gösterir.
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.
PARKING Park etmeye uygundur. Örneğin, otoparkta.

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ı. Yeri aramak için kullanılabilir.
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 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 kullanan 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 yerleşkesi, 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, yerin bileşik kodu (ör. "33GV+HQ, Ramberg, Norveç").

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. ccTLD ("üst düzey alan") olarak belirtilen, iki karakterli bir değer olan 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 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 şehir veya bağlı olduğu yeri 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üne sahip 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 bir 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, adreslenebilirlik durumlarına bakılmaksızın 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.