Method: geocode.destinations.searchDestinations

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

HTTP isteği

POST https://geocode.googleapis.com/v4alpha/geocode/destinations

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "travelModes": [
    enum (NavigationPoint.TravelMode)
  ],
  "languageCode": string,
  "regionCode": string,

  // Union field primary_query can be only one of the following:
  "place": string,
  "addressQuery": {
    object (SearchDestinationsRequest.AddressQuery)
  },
  "locationQuery": {
    object (SearchDestinationsRequest.LocationQuery)
  }
  // End of list of possible types for union field primary_query.
}
Alanlar
travelModes[]

enum (NavigationPoint.TravelMode)

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

string

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

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

object (SearchDestinationsRequest.AddressQuery)

Açık adrestir.
locationQuery

object (SearchDestinationsRequest.LocationQuery)

Tam konum

Yanıt metni

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

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "destinations": [
    {
      object (Destination)
    }
  ]
}
Alanlar
destinations[]

object (Destination)

Hedeflerin listesi.

Birincil hedef, birincil sorgudan 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.

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

SearchDestinationsRequest.AddressQuery

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

JSON gösterimi 
{

  // Union field kind can be only one of the following:
  "address": {
    object (PostalAddress)
  },
  "addressQuery": string
  // End of list of possible types for union field kind.
}
Alanlar
kind birleşik alanı. Adres sorgusu. kind aşağıdakilerden yalnızca biri olabilir:
address

object (PostalAddress)

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

string

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

SearchDestinationsRequest.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, containingPlaces alanına bina dahil edilir.

JSON gösterimi 
{
  "placeFilter": {
    object (SearchDestinationsRequest.LocationQuery.PlaceFilter)
  },

  // Union field kind can be only one of the following:
  "location": {
    object (LatLng)
  }
  // End of list of possible types for union field kind.
}
Alanlar
placeFilter

object (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

object (LatLng)

Tam bir LatLng konumu.

SearchDestinationsRequest.LocationQuery.PlaceFilter

Hedef adaylara uygulanacak filtreler.

JSON gösterimi 
{
  "structureType": enum (PlaceView.StructureType),
  "addressability": enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)
}
Alanlar
structureType

enum (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

enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)

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

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

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

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.

Hedef

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

JSON gösterimi 
{
  "primary": {
    object (PlaceView)
  },
  "containingPlaces": [
    {
      object (PlaceView)
    }
  ],
  "subDestinations": [
    {
      object (PlaceView)
    }
  ],
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "entrances": [
    {
      object (Entrance)
    }
  ],
  "navigationPoints": [
    {
      object (NavigationPoint)
    }
  ],
  "parkingOptions": {
    object (Destination.ParkingOptions)
  },
  "arrivalSummary": {
    object (Destination.ArrivalSummary)
  }
}
Alanlar
primary

object (PlaceView)

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

object (PlaceView)

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

object (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[]

object (Landmark)

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

object (Entrance)

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

object (NavigationPoint)

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

object (Destination.ParkingOptions)

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

object (Destination.ArrivalSummary)

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

PlaceView

Places API'deki bir yerin 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 displayName alanları için Places API tarafından döndürülenlerden farklı olabilir.

JSON gösterimi 
{
  "place": string,
  "displayName": {
    object (LocalizedText)
  },
  "primaryType": string,
  "types": [
    string
  ],
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "structureType": enum (PlaceView.StructureType),
  "location": {
    object (LatLng)
  },
  "displayPolygon": {
    object
  },
  "addressComponents": [
    {
      object (PlaceView.AddressComponent)
    }
  ]
}
Alanlar
place

string

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

string

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

object (LocalizedText)

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

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

string

Tek satırlık adres.
postalAddress

object (PostalAddress)

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

enum (PlaceView.StructureType)

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

object (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.
displayPolygon

object (Struct format)

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 displayPolygon nesnesi birden fazla poligonu temsil edebilir.
addressComponents[]

object (PlaceView.AddressComponent)

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

PlaceView.AddressComponent

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

JSON gösterimi 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Alanlar
longText

string

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

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

string

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

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

JSON gösterimi 
{
  "relationalDescription": {
    object (LocalizedText)
  },
  "tags": [
    enum (Landmark.Tag)
  ],
  "straightLineDistanceMeters": number,
  "travelDistanceMeters": number,

  // Union field landmark can be only one of the following:
  "place": {
    object (PlaceView)
  }
  // End of list of possible types for union field landmark.
}
Alanlar
relationalDescription

object (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[]

enum (Landmark.Tag)

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

number

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

number

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

object (PlaceView)

Bu simge yapıyı temsil eden yer.

Landmark.Tag

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.

Giriş

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

JSON gösterimi 
{
  "location": {
    object (LatLng)
  },
  "tags": [
    enum (Entrance.Tag)
  ],
  "place": string,
  "streetViewThumbnail": {
    object (StreetViewThumbnail)
  },
  "streetViewAnnotation": {
    object (ImageAnnotation)
  }
}
Alanlar
location

object (LatLng)

Girişin konumu.
tags[]

enum (Entrance.Tag)

Girişi açıklayan etiketlerin listesi.
place

string

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

object (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.
streetViewAnnotation

object (ImageAnnotation)

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

Entrance.Tag

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şte bu etiket yoksa girişin fiziksel olarak ana 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 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ş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.

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.

JSON gösterimi 
{
  "pano": string,
  "widthPx": integer,
  "heightPx": integer,
  "headingDegree": number,
  "pitchDegree": number,
  "fovDegree": number
}
Alanlar
pano

string

Belirli bir panorama kimliği.
widthPx

integer

Çı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.
heightPx

integer

Çı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.
headingDegree

number

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

number

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

number

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.

ImageAnnotation

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

JSON gösterimi 
{
  "coordinates": [
    {
      object (ImageAnnotation.Coordinate)
    }
  ]
}
Alanlar
coordinates[]

object (ImageAnnotation.Coordinate)

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

ImageAnnotation.Coordinate

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.

JSON gösterimi 
{
  "xPx": number,
  "yPx": number
}
Alanlar
xPx

number

X koordinatı.
yPx

number

Y koordinatı.

Destination.ParkingOptions

Hedefteki otopark seçenekleri hakkında bilgi.

JSON gösterimi 
{
  "availability": enum (Destination.ParkingOptions.Availability),
  "onsiteParking": boolean,
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Alanlar
availability

enum (Destination.ParkingOptions.Availability)

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

boolean

Hedefte tesis içi otopark vardır.
freeParkingLot

boolean

Ücretsiz otoparklar sunar.
paidParkingLot

boolean

Ücretli otoparklar sunar.
freeStreetParking

boolean

Cadde üzerinde ücretsiz park yeri sunar.
paidStreetParking

boolean

Cadde üzerinde ücretli park yeri sunar.
valetParking

boolean

Vale park hizmeti sunar.
freeGarageParking

boolean

Ücretsiz kapalı otopark sunar.
paidGarageParking

boolean

Ücretli kapalı otopark sunar.

Destination.ParkingOptions.Availability

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 kullanılamıyor.
PLENTY Yeterli sayıda park yeri mevcuttur.
SOMEWHAT_DIFFICULT Park yeri bulmak biraz zor.
DIFFICULT Park yeri bulmak çok zor.

Destination.ArrivalSummary

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

JSON gösterimi 
{
  "text": {
    object (LocalizedText)
  },
  "flagContentUrl": string,
  "disclosureText": {
    object (LocalizedText)
  }
}
Alanlar
text

object (LocalizedText)

Hedefe varış deneyiminin özeti.
flagContentUrl

string

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

object (LocalizedText)

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