Method: geocode.destinations.searchDestinations

Bu yöntem, hedef araması yapar ve hedeflerin listesini döndürür.

HTTP isteği

POST https://geocode.googleapis.com/v4/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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "place": string,
  "addressQuery": {
    object (SearchDestinationsRequest.AddressQuery)
  },
  "locationQuery": {
    object (SearchDestinationsRequest.LocationQuery)
  }
  // End of mutually exclusive fields.
}
Alanlar
travelModes[]

enum (NavigationPoint.TravelMode)

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

string

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

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.

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 sorguya göre 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. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
place

string

Bir yerin places/{placeId} biçimindeki kaynak adı.
addressQuery

object (SearchDestinationsRequest.AddressQuery)

Açık adrestir.
locationQuery

object (SearchDestinationsRequest.LocationQuery)

Tam konum
Birbirini hariç tutan alanların sonu.

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 sorgudan birincil hedef net bir şekilde belirlenebiliyorsa hizmet bir sonuç döndürür. Aksi takdirde hizmet, anlam belirsizliğini gidermek için birden fazla sonuç veya sıfır sonuç döndürebilir.

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 hizmeti tarafından kullanılan biçime uygun olarak belirtin.

JSON gösterimi 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "address": {
    object (PostalAddress)
  },
  "addressQuery": string
  // End of mutually exclusive fields.
}
Alanlar
Adres sorgusu. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
address

object (PostalAddress)

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

string

Tek satır olarak biçimlendirilmiş açık adres.
Birbirini hariç tutan alanların sonu.

SearchDestinationsRequest.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 durumlarda containingPlaces alanı binayı içerir.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "location": {
    object (LatLng)
  }
  // End of mutually exclusive fields.
}
Alanlar
placeFilter

object (SearchDestinationsRequest.LocationQuery.PlaceFilter)

İsteğe bağlıdır. Hedef adaylara uygulanacak filtreler.
Konum sorgusu. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
location

object (LatLng)

Tam LatLng konumu.
Birbirini hariç tutan alanların sonu.

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ıdır. Belirtilirse tüm hedeflerin bu yapı türüne sahip birincil bir yere sahip olması garanti edilir. Bu durum, bazı hedeflerin filtrelenmesine veya döndürülen hedeflerin 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

enum (SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability)

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

Hedef

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

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

object (PlaceView)

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

object (PlaceView)

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

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

object (Landmark)

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

object (Entrance)

Bu hedefin girişleri.
navigationPoints[]

object (NavigationPoint)

Bu hedefin gezinme noktaları.

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 displayName alanları için Places API tarafından döndürülen değerden farklı olabilir.

JSON gösterimi 
{
  "place": string,
  "placeId": 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)

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

object (Struct format)

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

object (PlaceView.AddressComponent)

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

PlaceView.AddressComponent

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

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 ülkesi için bir adres bileşeninin uzun adı "Avustralya" olabilir.
shortText

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
languageCode

string

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

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "place": {
    object (PlaceView)
  }
  // End of mutually exclusive fields.
}
Alanlar
relationalDescription

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

enum (Landmark.Tag)

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

number

Yalnızca çıkış. Bu önemli noktadan varış noktasına olan yürüme mesafesi (metre cinsinden).
Önemli nokta. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
place

object (PlaceView)

Bu önemli yeri temsil eden yer.
Birbirini hariç tutan alanların sonu.

Landmark.Tag

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.

Giriş

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

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

object (LocalizedText)

İnsanlar tarafından okunabilir ad (ör. "B Kapısı", "Güney Girişi", "5. Cadde Girişi").
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).

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ş 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şler, ana fuaye alanına erişim sağlayan 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 giriş, birincil yere erişim sağlayabilir.