Giriş
Places API (Yeni) aşağıdaki API'leri içerir:
Bu dokümanda, yeni API'lere genel bir bakış sunulmaktadır.
Place Details (New)
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 işletme veya önemli yer hakkında ayrıntılı bilgi isteyebilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yer hakkında 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:
- Text Search (New)
- Yakında Arama (Yeni)
- Geocoding API
- Routes API
- Address Validation API
- Autocomplete (New)
Place Photos (Yeni)
Place Photos (New), Google Places 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.
Place Photos (New) API'ye gönderilen 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ı şu yöntemleri kullanarak alabilirsiniz:
Fotoğraf kaynağı adını Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakında Arama (Yeni) isteğinin yanıtına dahil etmek için isteğin alan maskesine photos alanını eklediğinizden emin olun.
Text Search (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: "İstanbul'da acılı vejetaryen yemekleri" veya "İzmir'de 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 yönlendirmeyi veya aramayı belirli bir konumla kısıtlamayı da belirtebilirsiniz.
-
Yer türlerinin listesiyle birlikte aranacak bir bölge belirtmenize olanak tanır. Bölgeyi, merkez noktasının enlem ve boylam koordinatları ve metre cinsinden yarıçapıyla 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 pizza restoranını aramak için "
pizza_restaurant" ve "shopping_mall" değerlerini belirtin.
İki arama arasındaki temel fark, Text Search'ün (Yeni) rastgele bir arama dizesi belirtmenize olanak tanıması, Yakında Arama'nın (Yeni) ise arama yapılacak belirli bir alan gerektirmesidir.
Autocomplete (New) ve oturum jetonları
Autocomplete (New), 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. Autocomplete (New), faturalandırma amacıyla bir 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 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, bir 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 |
Yerin kabul ettiği ödeme seçenekleri. Bir yer birden fazla ödeme seçeneği kabul edebilir. Ödeme seçeneği verileri mevcut değilse ödeme seçeneği alanı ayarlanmaz. Seçenekler şunlardır:
|
parkingOptions |
Yerin sunduğu otopark 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 |
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 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 zamanda kullanılabilir EV şarj cihazlarının sayısını gösterir. |
shortFormattedAddress |
Bir yerin kısa ve okunabilir adresi. |
primaryType |
Belirli bir 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ı. Varsa istek diline göre yerelleştirilir. Olası değerlerin tam listesi için Desteklenen türler bölümüne bakın. |
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 dahil olmak üzere navigasyonun sona erebileceği bir yolun yanındaki konumdur. |
Özellikler
Places API (Yeni), birkaç yeni özellik içerir:
| Özellik | Açıklama |
|---|---|
outdoorSeating |
Açık havada oturma alanı vardır. |
liveMusic |
Mekanda canlı müzik vardır. |
menuForChildren |
Mekanda çocuk menüsü var. |
servesCocktails |
Kokteyl servisi var. |
servesDessert |
Mekanda tatlı servisi yapılır. |
servesCoffee |
Mekanda kahve servisi var. |
goodForChildren |
Çocuklar için uygun bir yer. |
allowsDogs |
Köpek kabul ediliyor. |
restroom |
Yerde tuvalet var. |
goodForGroups |
Gruplar için uygun bir yer. |
goodForWatchingSports |
Mekan, spor etkinliklerini izlemek için uygundur. |
Erişilebilirlik seçenekleri
Places API (Yeni), aşağıdaki erişilebilirlik seçeneği alanlarını içerir:
| Alan | Açıklama |
|---|---|
wheelchairAccessibleParking |
Yerde tekerlekli sandalye kullanıcılarına uygun park yeri var. |
wheelchairAccessibleEntrance |
Yerin tekerlekli sandalye kullanıcılarına 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, kullanıcıların nereye gideceklerine karar vermelerine yardımcı olabilecek yerler ve alanlar hakkında özetler döndürmek için Gemini modelinin özelliklerini kullanır.
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 restoran denemeyi düşünüyorsanız yapay zeka destekli bir özet, menüdeki popüler yemekleri gösterebilir, restoranın atmosferi hakkında fikir verebilir veya kullanıcı yorumlarındaki ortak temaları bir araya getirebilir. Yeni bir şehri ziyaret ediyorsanız yapay zeka destekli özet, yakındaki turistik 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), Text Search (New) ve Yakında 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ış özetleri olan yer özetleri.
- Yorum özetleri: Yorumcuların bir yer hakkında söylediklerinin kolay anlaşılır özetleridir.
- Ç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, mevcut en son bilgilere göre güncel olduklarından emin olmak için bu ö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
- Text Search'e (New) geçiş yapma
- Place Photos'a (Yeni) geçiş yapma
- Otomatik Tamamlama'ya (Yeni) geçiş yapma