Giriş
Places API (Yeni) aşağıdaki API'leri içerir:
- Yer Ayrıntıları (Yeni)
- Yer Fotoğrafları (Yeni)
- Yakında Arama (Yeni)
- Metin Arama (Yeni)
- Otomatik tamamlama (yeni)
Bu belgede, yeni API'lere genel bakış sunulmaktadır.
Yer Ayrıntıları (Yeni)
Yer kimliği, Google Places veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımlar. Yer kimliğiyle, Yer Ayrıntıları (Yeni) isteği başlatarak belirli bir kuruluş veya ilgi çekici yer hakkında ayrıntı isteğinde bulunabilirsiniz. Bir Yer Ayrıntıları (Yeni) isteği, belirtilen yerle ilgili kapsamlı bilgiler (ör. tam adresi, telefon numarası, kullanıcı puanı ve yorumları) döndürür.
Yer kimliği edinmenin birçok yolu vardır. Şunları kullanabilirsiniz:
- Metin Arama (Yeni)
- Yakında Arama (Yeni)
- Geocoding API
- Routes API
- Address Validation API
- Otomatik tamamlama (yeni)
Yer Fotoğrafları (Yeni)
Yer Fotoğrafları (Yeni), Google Yerler veritabanında depolanan milyonlarca fotoğrafa erişmenizi sağlayarak uygulamanıza yüksek kaliteli fotoğraf içerikleri eklemenize olanak tanır. Place Photos (New) API'yi kullanarak fotoğraflara erişebilir ve resmi uygulamanız için ideal boyuta yeniden boyutlandırabilirsiniz.
Place Photos (New) API'ye yapılan tüm istekler, döndürülecek fotoğrafı benzersiz şekilde tanımlayan bir fotoğraf kaynağı adı içermelidir. Fotoğraf kaynağı adını almak için şunları kullanabilirsiniz:
Bir Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakınlardaki Arama (Yeni) isteğinden gelen yanıta fotoğraf kaynağı adını eklemek için isteğin alan maskesine photos alanını eklediğinizden emin olun.
Metin Arama (Yeni) ve Yakında Arama (Yeni)
Places API iki arama API'si içerir:
-
Bir yer aramak için metin dizesi belirtmenize olanak tanır. Örneğin: "Avustralya, Sidney'de acı vejetaryen yemekler" veya "Kaliforniya, Palo Alto yakınlarında kaliteli deniz ürünleri restoranı".
Fiyat seviyeleri, mevcut açılış durumu, puanlar veya belirli yer türleri gibi ayrıntıları belirterek aramayı daraltabilirsiniz. Ayrıca, sonuçları belirli bir konuma göre düzenleyebilir veya aramayı belirli bir konumla sınırlayabilirsiniz.
-
Aranacak bölgeyi ve yer türlerinin listesini belirtmenize olanak tanır. Bölgeyi, merkez noktanın enlem ve boylam koordinatları ile yarıçapı (metre cinsinden) tarafından tanımlanan bir daire olarak belirtin.
Yerin özelliklerini tanımlayan bir veya daha fazla yer türü belirtin. Örneğin, belirtilen bölgedeki bir alışveriş merkezinde bulunan bir pizza restoranını aramak için "
pizza_restaurant" ve "shopping_mall" değerlerini belirtin.
İki arama arasındaki temel fark, Metin Arama (Yeni) özelliğinin rastgele bir arama dizesi belirtmenize olanak tanıması, Yakınlardaki Arama (Yeni) özelliğinin ise arama yapılacak belirli bir alan gerektirmesidir.
Otomatik Tamamlama (Yeni) ve oturum jetonları
Autocomplete (Yeni), bir HTTP isteğine yanıt olarak yer tahminleri ve sorgu tahminleri döndüren bir web hizmetidir. İstekle birlikte, arama alanını kontrol eden bir metin arama dizesi ve coğrafi sınırlar belirtin.
Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını oturum olarak izleyen, kullanıcı tarafından oluşturulan dizelerdir. Otomatik Tamamlama (Yeni), faturalandırma amacıyla kullanıcının otomatik tamamlama aramasının sorgu ve seçim aşamalarını ayrı bir oturumda gruplandırmak için oturum jetonlarını kullanır.
Yeni alanlar, özellikler ve erişilebilirlik seçenekleri
Places API (Yeni), kullanıcılara bir yer hakkında daha fazla bilgi sağlamak için yeni alanlar, özellikler ve erişilebilirlik seçenekleri içerir. Bu yönler aşağıdaki bölümlerde açıklanmıştır.
Alanlar
Places API (Yeni) birkaç yeni alan içerir:
| Alan | Açıklama |
|---|---|
regularSecondaryOpeningHours |
Belirli işlemler için belirli zamanları açıklar. İkincil çalışma saatleri, işletmenin ana çalışma saatlerinden farklıdır. Örneğin, bir restoran, ikinci çalışma saatleri olarak arabaya servis saatlerini veya teslimat saatlerini belirtebilir. |
paymentOptions |
Mekanın kabul ettiği ödeme seçenekleri. Bir yer birden fazla ödeme seçeneğini kabul edebilir. Ödeme seçeneği verileri kullanılamıyorsa ödeme seçeneği alanı ayarlanmamış olur. Seçenekler şunlardır:
|
parkingOptions |
Mekanın sunduğu otopark seçenekleri. Seçenekler şunlardır:
|
subDestinations |
Belirli bir yerle ilgili benzersiz yerler. Örneğin, havalimanı terminalleri, havalimanının alt hedefleri olarak kabul edilir. |
fuelOptions |
Bir benzin istasyonunda bulunan yakıt seçenekleriyle ilgili en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir. Aşağıdaki seçenekler mevcuttur:
|
evChargeOptions |
Bu istasyondaki elektrikli araç şarj cihazlarının sayısı. Bazı EV şarj noktalarında birden fazla konnektör bulunsa da her şarj noktası aynı anda yalnızca bir aracı şarj edebilir. Bu nedenle, bu alan belirli bir zamanda kullanılabilen EV şarj noktalarının sayısını yansıtır. |
shortFormattedAddress |
Bir yerin kısa ve kullanıcılar tarafından okunabilir adresi. |
primaryType |
Belirtilen sonucun birincil türü. Örneğin, bir yer cafe veya airport olarak sınıflandırılabilir. Bir yerin yalnızca tek bir birincil türü olabilir. Olası değerlerin tam listesi için Desteklenen türler başlıklı makaleye bakın. |
primaryTypeDisplayName |
Birincil türün görünen adı (varsa istek diline yerelleştirilmiş). Olası değerlerin tam listesi için Desteklenen türler bölümüne bakın. |
Özellikler
Places API (Yeni) birkaç yeni özellik içerir:
| Özellik | Açıklama |
|---|---|
outdoorSeating |
Mekanda açık havada oturma alanı vardır. |
liveMusic |
Mekanda canlı müzik vardır. |
menuForChildren |
Çocuk menüsü var. |
servesCocktails |
Mekanda kokteyl servisi var. |
servesDessert |
Tatlı servisi var. |
servesCoffee |
Kahve servisi var. |
goodForChildren |
Çocuklar için uygun bir yer. |
allowsDogs |
Mekana köpek kabul ediliyor. |
restroom |
Mekanda tuvalet vardır. |
goodForGroups |
Mekanda gruplar ağırlanır. |
goodForWatchingSports |
Mekanda spor etkinlikleri izlenebilir. |
Erişilebilirlik seçenekleri
Places API (Yeni) aşağıdaki erişilebilirlik seçeneği alanlarını içerir:
| Alan | Açıklama |
|---|---|
wheelchairAccessibleParking |
Tesis, tekerlekli sandalye kullanıcılarına uygun park yeri sunuyor. |
wheelchairAccessibleEntrance |
Mekanın tekerlekli sandalyeye uygun girişi var. |
wheelchairAccessibleRestroom |
Mekanda tekerlekli sandalye kullanıcılarına uygun tuvalet var. |
wheelchairAccessibleSeating |
Mekanda tekerlekli sandalye kullanıcılarına uygun oturma düzeni var. |
Yapay zeka destekli özetler
Places API (Yeni) yapay zeka destekli özetler, yerler ve bölgeler hakkında özetler döndürmek için Gemini modelinin özelliklerini kullanır. Bu özetler, kullanıcıların nereye gideceklerine karar vermelerine yardımcı olabilir.
Yapay zeka destekli özetler, kullanıcıların bir yer hakkında daha bilinçli kararlar vermesine yardımcı olmak için çeşitli girişlerden gelen verileri sentezler. Örneğin, yeni bir restorana gitmeyi düşünüyorsanız yapay zeka destekli özetler, menüdeki popüler yemekleri öne çıkarabilir, restoranın atmosferi hakkında fikir verebilir veya kullanıcı yorumlarındaki temaları bir araya getirebilir. Yeni bir şehri ziyaret ediyorsanız yapay zeka destekli özetler sayesinde yakındaki ilgi çekici yerler ve olanaklar hakkında genel bilgi edinebilirsiniz.
Places API'ye (Yeni) yapay zeka destekli özellikler eklendi
Yapay zeka destekli özetler; Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakınlardaki Arama (Yeni) tarafından desteklenir. Aşağıdaki yapay zeka destekli özetler, Places API (New) yanıtlarında kullanılabilir:
- Belirli bir yerle ilgili kısa genel bakış özetleri olan yer özetleri.
- Yorum özetleri: Yorumcuların bir yer hakkında söylediklerinin kolayca anlaşılabilir özetleri.
- Çevredeki yakın ve popüler yerlere genel bakış sunan bölge özetleri. Bunlar arasında mahalle özetleri ve elektrikli araç şarj istasyonu özetleri yer alır.
Google, bu özetlerin en güncel bilgilere göre hazırlanmasını sağlamak için özetleri sık sık yeniden oluşturur. Places API (Yeni) isteği gönderdiğinizde uygulamanızda en güncel veriler gösterilir.
Yeni Places API'lerine geçiş
Mevcut bir Places API (New) müşterisiyseniz ve uygulamanızı yeni API'leri kullanacak şekilde taşımak istiyorsanız aşağıdaki taşıma belgelerine bakın:
- Yer Ayrıntıları'na (Yeni) geçiş
- Yakında Arama'ya (Yeni) geçiş
- Metin Arama'ya geçiş (Yeni)
- Yer Fotoğrafları'na (Yeni) geçiş yapma
- Otomatik Tamamlama'ya geçiş (Yeni)