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 bir bakış sunulmaktadır.
Yer Ayrıntıları (Yeni)
Yer kimliği, Google Places veritabanında ve Google Haritalar'da bir yeri benzersiz bir şekilde tanımlar. Yer kimliğiyle, Yer Ayrıntıları (Yeni) isteği başlatarak belirli bir kuruluş veya önemli yer hakkında ayrıntı isteğinde bulunabilirsiniz. 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 en uygun boyuta yeniden boyutlandırabilirsiniz.
Yer Fotoğrafları (Yeni) API'ye yapılan tüm istekler, döndürülecek fotoğrafı benzersiz şekilde tanımlayan bir fotoğraf kaynak adı içermelidir. Fotoğraf kaynağı adını almak için şunları kullanabilirsiniz:
Bir Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakınlarda 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 (Yeni) iki arama API'si içerir:
-
Bir yer aramak için metin dizesi belirtmenize olanak tanır. Örneğin: "Avustralya, Sidney'deki acı vejetaryen yemekleri" veya "Kaliforniya, Palo Alto yakınlarındaki kaliteli deniz ürünleri restoranları".
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 yönlendirebilir veya aramayı belirli bir konumla sınırlayabilirsiniz.
-
Aramak için bir bölge ve yer türleri listesi belirtmenize olanak tanır. Bölgeyi, merkez noktanın enlem ve boylam koordinatları ile metre cinsinden yarıçapı 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.
Bu iki arama arasındaki temel fark, Metin Arama (Yeni) özelliğinin rastgele bir arama dizesi belirtmenize olanak tanıması, Yakındaki 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), kullanıcının otomatik tamamlama aramasının sorgu ve seçim aşamalarını faturalandırma amacıyla 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, arabaya servis saatlerini veya teslimat saatlerini ikincil çalışma saatleri olarak 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 arasında şunlar bulunur:
|
parkingOptions |
Yer tarafından sunulan otopark seçenekleri. Seçenekler arasında şunlar bulunur:
|
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çenekleri hakkında 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 cihazlarında birden fazla konnektör bulunsa da her şarj cihazı aynı anda yalnızca bir aracı şarj edebilir. Bu nedenle, bu alan belirli bir anda kullanılabilen EV şarj cihazlarının sayısını yansıtır. |
shortFormattedAddress |
Bir yerin kısa ve 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ı makaleyi inceleyin. |
primaryTypeDisplayName |
Birincil türün görünen adı (geçerliyse istek diline yerelleştirilmiş). Olası değerlerin tam listesi için Desteklenen türler başlıklı makaleyi inceleyin. |
entrances |
Hedefin girişleri. Giriş, bir yerin giriş ve çıkış noktasının konumunu tanımlayan tek bir enlem/boylam koordinat çiftidir. |
navigationPoints |
Hedef için navigasyon noktaları. Navigasyon noktası, desteklenen seyahat modları ve kullanımları da dahil olmak üzere navigasyonun sona erebileceği, yolun yanındaki bir konumdur. |
Ö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 dinletisi 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 var. |
goodForGroups |
Mekanda gruplar ağırlanır. |
goodForWatchingSports |
Burası spor etkinliklerini izlemek için uygun. |
Erişilebilirlik seçenekleri
Places API (Yeni) aşağıdaki erişilebilirlik seçeneği alanlarını içerir:
| Alan | Açıklama |
|---|---|
wheelchairAccessibleParking |
Tekerlekli sandalye kullanıcılarına uygun park yeri sunuluyor. |
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, Gemini modelinin özelliklerini kullanarak yerler ve bölgeler hakkında özetler döndürü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 bir özet, menüdeki popüler yemekleri öne çıkarabilir, size 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, yakındaki ilgi çekici yerler ve olanaklar hakkında genel bir bakış sunabilir.
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.
- Bölge özetleri: Çevredeki yakındaki ve popüler yerlere genel bakış sunar. Bunlar arasında mahalle özetleri ve elektrikli araç şarj istasyonu özetleri yer alır.
Google, mevcut en son bilgilere dayalı olarak bu özetlerin güncel olması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.
Places API'ye (Yeni) geçiş yapma
Mevcut bir Places API (Eski) müşterisiyseniz ve uygulamanızı Places API (Yeni) kullanacak şekilde taşımak istiyorsanız aşağıdaki taşıma belgelerine bakın:
- Yer Ayrıntıları'na (Yeni) geçiş yapma
- Yakında Arama'ya (Yeni) geçiş yapma
- Metin Arama'ya (Yeni) geçiş yapma
- Yer Fotoğrafları'na (Yeni) geçiş yapma
- Otomatik Tamamlama'ya (Yeni) geçiş yapma