- HTTP isteği
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- SearchDestinationsRequest.AddressQuery
- SearchDestinationsRequest.LocationQuery
- SearchDestinationsRequest.LocationQuery.PlaceFilter
- PlaceView.StructureType
- SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability
- NavigationPoint.TravelMode
- SearchDestinationsRequest.Effort
- Hedef
- PlaceView
- PlaceView.AddressComponent
- Önemli nokta
- Landmark.Tag
- Giriş
- Entrance.Tag
- StreetViewThumbnail
- ImageAnnotation
- ImageAnnotation.Coordinate
- NavigationPoint
- NavigationPoint.Usage
- Destination.ParkingOptions
- Destination.ParkingOptions.Availability
- Destination.ParkingOptions.ParkingFacility
- Destination.ArrivalSummary
Bu yöntem, hedef araması yapar 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 ( |
| Alanlar | |
|---|---|
travelModes[] |
İsteğe bağlıdır. Navigasyon noktalarının filtreleneceği seyahat modları. Bu, yanıtta döndürülen |
languageCode |
İsteğe bağlıdır. Sonuçların döndürüleceği dil. |
regionCode |
İ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. |
effort |
İsteğe bağlıdır. İstemci tarafından istenen çaba düzeyi. |
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 |
Bir yerin |
addressQuery |
Açık adrestir. |
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 ( |
| Alanlar | |
|---|---|
destinations[] |
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-platformhttps://www.googleapis.com/auth/maps-platform.geocodehttps://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 ( |
| Alanlar | |
|---|---|
| Adres sorgusu. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır: | |
address |
Posta adresi biçiminde bir açık adres. |
addressQuery |
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 ( |
| Alanlar | |
|---|---|
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 |
Tam LatLng konumu. |
| Birbirini hariç tutan alanların sonu. | |
SearchDestinationsRequest.LocationQuery.PlaceFilter
Hedef adaylara uygulanacak filtreler.
| JSON gösterimi |
|---|
{ "structureType": enum ( |
| Alanlar | |
|---|---|
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, Bu alanın bir başka kullanım amacı da bina görüntüleme poligonlarını daha kolay ayıklamaktır. Örneğin, |
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. |
SearchDestinationsRequest.Effort
Hedefleri çözmek için ayrılan çaba düzeyi.
| Sıralamalar | |
|---|---|
EFFORT_UNSPECIFIED |
Varsayılan değer. |
LOW |
En hızlı yanıt süreleri için optimizasyon sağlar. Genişletilmiş hiyerarşi geçişi veya karmaşık yer anlam belirsizliğini giderme olmadan doğrudan hedef araması yapar. |
MEDIUM |
Hız ve doğruluk arasında denge kurar. Çoğu istek standart düşük gecikmeyle döndürülür. Hizmet; belirsiz sorgular, birden fazla binanın bulunduğu siteler veya zorlu konumlar için varış noktalarını ve hiyerarşik bağlamı çözmek amacıyla ek işlemler uygular. Bu işlemler, birkaç saniyeye kadar sürebilen sınırlı bir gecikmeye neden olabilir. Kullanıcıların kısa bir duraklamayı tolere edebileceği etkileşimli iş akışları için önerilir. |
HIGH |
Karmaşık, resmi olmayan veya geniş alanlara yayılmış konumlar (büyük kampüsler veya apartman siteleri gibi) için hedef çözünürlüğü doğruluğunu ve eksiksizliğini en üst düzeye çıkarır. Yanıt süreleri önemli ölçüde daha uzun olabilir. Arka plan, toplu, sevkiyat veya lojistik ön yönlendirme iş akışları için önerilir. |
Hedef
Hedef. Buna birincil yer, ilgili yerler, girişler ve navigasyon noktaları dahildir.
| JSON gösterimi |
|---|
{ "primary": { object ( |
| Alanlar | |
|---|---|
primary |
İstekteki |
containingPlaces[] |
Birincil yerin içinde bulunduğu daha az hassas yerler. Örneğin, bu binayı içeren apartman kompleksi. |
subDestinations[] |
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[] |
Hedefin nerede olduğunu belirtmek veya varışa yardımcı olmak için kullanılabilecek önemli noktalar. |
entrances[] |
Bu hedefin girişleri. |
navigationPoints[] |
Bu hedefin gezinme noktaları. |
parkingOptions |
Bu hedef için park yeri seçenekleri. |
arrivalSummary |
Varış noktasındaki varış deneyiminin yapay zeka tarafından üretilmiş özeti. |
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 ( |
| Alanlar | |
|---|---|
place |
Bu yerin |
placeId |
Bir yerin benzersiz tanımlayıcısı. |
displayName |
İnsan tarafından okunabilen yer açıklaması. Örneğin, "B Kapısı", "McDonalds" |
primaryType |
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[] |
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 |
Tek satırlık adres. |
postalAddress |
Yapılandırılmış adres. |
structureType |
Bu yere karşılık gelen yapı türü. |
location |
Bu yerin konumu. Poligonların gösterildiği yerlerde bu, haritaya işaretçi yerleştirmek için iyi bir nokta olabilir. |
displayPolygon |
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 |
addressComponents[] |
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 |
Adres bileşeninin tam metin açıklaması veya adı. Örneğin, Avustralya ülkesi için bir adres bileşeninin uzun adı "Avustralya" olabilir. |
shortText |
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[] |
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 |
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 ( |
| Alanlar | |
|---|---|
relationalDescription |
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[] |
Önemli yerin varış noktası bağlamında nasıl kullanılabileceğini açıklayan etiketler. |
straightLineDistanceMeters |
Yalnızca çıkış. Bu önemli noktadan hedefe olan düz çizgi mesafesi (metre cinsinden). |
travelDistanceMeters |
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 |
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 ( |
| Alanlar | |
|---|---|
displayName |
İnsanlar tarafından okunabilir ad (ör. "B Kapısı", "Güney Girişi", "5. Cadde Girişi"). |
location |
Girişin konumu. |
tags[] |
Girişi açıklayan etiketlerin listesi. |
place |
Bu girişin fiziksel olarak bulunduğu yapı ( |
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 |
Yukarıda döndürülen |
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 Not: |
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.
| JSON gösterimi |
|---|
{ "pano": string, "widthPx": integer, "heightPx": integer, "headingDegree": number, "pitchDegree": number, "fovDegree": number } |
| Alanlar | |
|---|---|
pano |
Belirli bir panorama kimliği. |
widthPx |
Çı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. |
heightPx |
Çı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. |
headingDegree |
Kameranın derece cinsinden yatay yönü. Aralık [0, 360). 0, kuzeyi, 90 ise doğuyu gösterir. |
pitchDegree |
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. |
fovDegree |
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. |
ImageAnnotation
Görsel küçük resmindeki bir ek açıklama (ör. girişi çevreleyen bir çokgen).
| JSON gösterimi |
|---|
{
"coordinates": [
{
object ( |
| Alanlar | |
|---|---|
coordinates[] |
Resim üzerinde 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ğıya doğru ilerler.
| JSON gösterimi |
|---|
{ "xPx": number, "yPx": number } |
| Alanlar | |
|---|---|
xPx |
X koordinatı. |
yPx |
Y koordinatı. |
Destination.ParkingOptions
Hedefteki park seçenekleri hakkında bilgi.
| JSON gösterimi |
|---|
{ "availability": enum ( |
| Alanlar | |
|---|---|
availability |
Bu hedefte otopark olup olmadığı. |
parkingFacilities[] |
Bu hedefteki otopark olanakları. |
onsiteParking |
Varış noktasında otopark vardır. |
freeParkingLot |
Ücretsiz otoparklar sunulur. |
paidParkingLot |
Ücretli otoparklar sunar. |
freeStreetParking |
Cadde üzerinde ücretsiz park yeri sunulur. |
paidStreetParking |
Cadde üzerinde ücretli park yeri sunar. |
valetParking |
Vale park hizmeti sunulur. |
freeGarageParking |
Ücretsiz kapalı otoparkı vardır. |
paidGarageParking |
Ücretli kapalı otoparkı var. |
Destination.ParkingOptions.Availability
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. |
Destination.ParkingOptions.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.
| JSON gösterimi |
|---|
{
"place": {
object ( |
| Alanlar | |
|---|---|
place |
Bu otopark tesisinin yer temsili. |
onsite |
Bu otopark tesisinin birincil varış noktasında bulunup bulunmadığı bilgisi. Bu alan ayarlanmazsa yerinde çalışma durumu bilinmez. |
popular |
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. |
straightLineDistanceMeters |
Birincil varış noktasından bu otopark tesisine olan kuş uçuşu mesafe (metre cinsinden). |
Destination.ArrivalSummary
Varış noktasındaki varış deneyiminin yapay zeka tarafından üretilmiş özeti.
| JSON gösterimi |
|---|
{ "text": { object ( |
| Alanlar | |
|---|---|
text |
Varış noktasındaki varış deneyiminin özeti. |
flagContentUrl |
Kullanıcıların özetle ilgili bir sorunu bildirebileceği bir bağlantı. |
disclosureText |
Yalnızca çıkış. Varış özetiyle ilgili açıklama metnini içerir. |