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, bu yeni API'lere genel bir bakış sunulmaktadır.
Yer Ayrıntıları (Yeni)
Yer kimliği, Google Rehber 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 tesis veya önemli yer hakkında ayrıntı isteğinde bulunabilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yerle ilgili tam adres, telefon numarası, kullanıcı puanı ve yorumlar gibi kapsamlı bilgiler 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şim sağlayarak uygulamanıza yüksek kaliteli fotoğraf içerikleri eklemenize olanak tanır. Place Photos (Yeni) API'yi kullanarak fotoğraflara erişebilir ve resmi uygulamanız için en uygun boyuta yeniden boyutlandırabilirsiniz.
Place Photos (Yeni) API'ye gönderilen tüm isteklerde, döndürülecek fotoğrafı benzersiz şekilde tanımlayan bir fotoğraf kaynağı adı bulunmalıdır. Fotoğraf kaynağı adını şu şekilde edinebilirsiniz:
Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakındakiler Arama (Yeni) isteğinde fotoğraf kaynağı adını yanıta dahil etmek için isteğin alan maskesine photos alanını eklediğinizden emin olun.
Metin Arama (Yeni) ve Yakında Arama (Yeni)
Yerler API'si iki arama API'si içerir:
-
Bir yer aramak için kullanılacak metin dizesini belirtmenizi sağlar. Örneğin: "Sidney, Avustralya'da baharatlı vejetaryen yemekler" veya "Palo Alto, CA yakınlarında deniz ürünleriyle ilgili lezzetli yemekler".
Fiyat seviyeleri, mevcut açık olma durumu, puanlar veya belirli yer türleri gibi ayrıntıları belirterek aramayı hassaslaştırabilirsiniz. Ayrıca, sonuçları belirli bir konuma göre yönlendirmeyi veya aramayı belirli bir konumla sınırlandırmayı da belirtebilirsiniz.
-
Yer türlerinin listesinin yanı sıra aranacak bir bölgeyi belirtmenize olanak tanır. Bölgeyi, merkez noktasını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"yi belirtin.
Bu iki arama arasındaki temel fark, Metin Arama'nın (Yeni) istediğiniz arama dizesini belirtmenize izin vermesi, Yakındakiler Arama'nın (Yeni) ise aramanın yapılacağı 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. İstekte, 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ı 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 konular 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 ikincil çalışma saatleri olarak arabalı sipariş veya teslimat saatlerini belirtebilir. |
paymentOptions |
Yerin kabul ettiği ödeme seçenekleri. Bir yer birden fazla ödeme seçeneğini kabul edebilir. Ödeme seçeneği verileri yoksa ödeme seçeneği alanının değeri sıfırlanır. Seçenekler şunlardır:
|
parkingOptions |
Tesisin sunduğu park seçenekleri. Seçenekler şunlardır:
|
subDestinations |
Belirli bir yerle ilgili benzersiz yerler. Örneğin, havaalanı terminalleri bir havaalanının alt varış noktaları olarak kabul edilir. |
fuelOptions |
Bir benzin istasyonunda sunulan yakıt seçenekleri hakkında en güncel bilgiler. Bu bilgiler düzenli olarak güncellenir. Seçenekler şunlardır:
|
evChargeOptions |
Bu istasyondaki elektrikli araç (EV) şarj noktaları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ılabilir EV şarj noktaları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 konumun yalnızca tek bir birincil türü olabilir. Olası değerlerin tam listesi için Desteklenen türler bölümüne 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 |
Açık havada oturma alanı mevcuttur. |
liveMusic |
Canlı müzik hizmeti sunan yerler |
menuForChildren |
Çocuk menüsü mevcuttur. |
servesCocktails |
Burada kokteyl servisi var. |
servesDessert |
Tatlı servisi var. |
servesCoffee |
Kahve servisi var. |
goodForChildren |
Çocuklar için iyi bir yer. |
allowsDogs |
Tesiste köpeklere izin veriliyor. |
restroom |
Tesiste tuvalet var. |
goodForGroups |
Yer, gruplara uygundur. |
goodForWatchingSports |
Burası spor etkinliklerini izlemek için uygun bir yer. |
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 mevcuttur. |
wheelchairAccessibleEntrance |
Tesisin tekerlekli sandalye kullanıcılarına uygun girişi var. |
wheelchairAccessibleRestroom |
Tesiste tekerlekli sandalye kullanıcılarına uygun tuvalet var. |
wheelchairAccessibleSeating |
Tekerlekli sandalye kullanıcılarına uygun oturma düzeni var. |
Yapay zeka destekli özetler
Places API (Yeni) Yapay zeka destekli özetler, kullanıcıların nereye gideceğine karar vermesine yardımcı olabilecek yerler ve alanlarla ilgili özetler döndürmek için Gemini model özelliklerini kullanır.
Yapay zeka destekli özetler, kullanıcıların bir yer hakkında daha bilinçli kararlar vermelerine yardımcı olmak için çeşitli girişlerden gelen verileri sentez eder. Örneğin, yeni bir restoran denemeyi düşünüyorsanız yapay zeka destekli bir özet, menünün öne çıkanlarını gösterebilir, restoranın atmosferi hakkında fikir verebilir veya kullanıcı yorumlarından temalar derleyebilir. Yeni bir şehri ziyaret ediyorsanız yapay zeka destekli bir özet, yakındaki turistik yerlere ve olanaklara genel bir bakış sunabilir.
Places API'ye eklenen yapay zeka destekli özellikler (Yeni)
Yapay zeka destekli özetler Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakındakiler Arama (Yeni) tarafından desteklenir. Places API (Yeni) yanıtlarında aşağıdaki yapay zeka destekli özetler kullanılabilir:
- Belirli bir yerle ilgili kısa genel bakış özetlerinden oluşan yer özetleri.
- Yorumcuların bir yer hakkında söylediklerinin özetlendiği yorum özetleri.
- Yakındaki ve popüler yerlere genel bakış sunan bölge özetleri. Bunlara mahalle özetleri ve elektrikli araç şarj istasyonu özetleri dahildir.
Google, mevcut en güncel bilgilere göre güncel olmasını sağlamak için bu özetlerin sık sık yeniden oluşturulmasını sağlar. Places API (Yeni) isteği gönderdiğinizde uygulamanızda en güncel verileri gösterirsiniz.
Yeni Places API'lerine geçiş
Mevcut bir Places API (Yeni) müşterisiyseniz ve uygulamanızı yeni API'leri kullanacak şekilde taşımak istiyorsanız aşağıdaki taşıma dokümanlarına bakın:
- Yer Ayrıntıları'na taşıma (Yeni)
- Yakında Arama'ya geçiş (Yeni)
- Metin aramaya taşıma (Yeni)
- Yer Fotoğrafları'na taşıma (Yeni)
- Otomatik Tamamlama'ya taşıma (Yeni)