Places API (Yeni) aşağıdaki API'leri içerir:
- Yer Ayrıntıları (Yeni)
- Yer Fotoğrafı (Yeni)
- Yakında Arama (Yeni)
- Metin Arama (Yeni)
- Otomatik tamamlama (Yeni)
Bu belgede, bu yeni API'lere genel bakış sunulmaktadır.
Yer Ayrıntıları (Yeni)
Yer kimliği, Google Rehber veritabanındaki ve Google Haritalar. Yer kimliğiyle, belirli bir yerle ilgili ayrıntıları isteyebilirsiniz. Yer Ayrıntıları (Yeni) başlatarak bir tesis veya önemli yer isteği gönderin. Yer Ayrıntıları (Yeni) isteği, ve belirtilen yerin tam adresi, telefon numarası, kullanıcı oyları ve inceleme.
Yer kimliğini almanın birçok yolu vardır. Şunları kullanabilirsiniz:
- Metin Arama (Yeni)
- Yakında Arama (Yeni)
- Geocoding API
- Routes API
- Address Validation API
- Otomatik Yer Tamamlama
Yer Fotoğrafı (Yeni)
Yer Fotoğrafı (Yeni) API'si, yüksek kaliteli fotoğraf içerikleri eklemenize olanak tanır. depoladığınız milyonlarca fotoğrafa erişmenizi sağlayarak Google Rehber veritabanı. Yer Fotoğrafı (Yeni) API'sini kullanarak uygulamanız için en uygun boyuta getirmek üzere yeniden boyutlandırabilirsiniz.
Place Photo (Yeni) API'sine yapılan tüm istekler bir fotoğraf kaynağı adı içermelidir. Bu, döndürülecek fotoğrafı benzersiz şekilde tanımlar. Fotoğraf kaynağını edinebilirsiniz. şunu kullanarak adlandırın:
Yer Ayrıntılarından (Yeni) alınan yanıta fotoğraf kaynağının adını eklemek için:
Metin Arama (Yeni) veya Yakındaki Arama (Yeni) isteği için
photos alanına, isteğin alan maskesindeki değer girilmelidir.
Metin Arama (Yeni) ve Yakındaki Arama (Yeni)
Places API iki arama API'si içerir:
-
Bir yeri aramak için kullanılacak metin dizesi belirtmenizi sağlar. Örnek: "Avustralya, Sidney'de Acı Vejetaryen Yemek" veya "Yakındaki seçkin deniz ürünleri restoranları Palo Alto, CA" adresini ziyaret edin.
Fiyat düzeyleri, mevcut açılış durumu, puanlar veya belirli yer türleri. Ayrıca transkriptinizi sonuçlarda belirli bir konuma ağırlık vermeyi veya aramayı kısıtlamayı belirli bir konuma gidin.
-
Yer türlerinin bir listesiyle birlikte, arama yapılacak bir bölge belirtebilmenizi sağlar. Bölgeyi enlem ve boylam değerleriyle tanımlanan bir daire olarak belirtin merkez noktasının ve yarıçapın metre cinsinden koordinatları.
Bölgenin özelliklerini tanımlayan bir veya daha fazla yer türü belirtin. yer. Örneğin, "
pizza_restaurant" değerini belirtin ve "shopping_mall" - belirtilen bölgedeki bir alışveriş merkezinde yer alan bir pizza restoranını arayın bölge.
İki arama arasındaki temel fark şudur: Metin Arama (Yeni) rastgele bir arama dizesi belirtirken, Yakındaki Arama (Yeni) için belirli bir alanı seçin.
Otomatik tamamlama (Yeni) ve oturum jetonları
Otomatik tamamlama (Yeni), yer tahminleri ve bir HTTP isteğine yanıt olarak sorgu tahmininde bulunmanızı sağlar. İstekte bir metin belirtin arama dizesini ve arama alanını kontrol eden coğrafi sınırları içerir.
Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarını anlamına gelir. Otomatik Tamamlama (Yeni), sorguyu gruplandırmak ve Kullanıcı otomatik tamamlama aramasının kullanıcılarınızın belirli bir kullanıcı grubu için ayrı bir oturumda .
Yeni alanlar, özellikler ve erişilebilirlik seçenekleri
Places API (Yeni) ile yeni alanlar, özellikler ve erişilebilirlik seçenekleri Böylece kullanıcılara bir yer hakkında daha fazla bilgi verebilir. Bu unsurlar, aşağıdaki bölümlerde açıklanmıştır.
Alanlar
Places API (Yeni) birçok yeni alan içeriyor:
| Alan | Açıklama |
|---|---|
regularSecondaryOpeningHours |
Belirli işlemlerin belirli zamanlarını açıklar. İkincil çalışma saatleri, bir işletmenin temel saatlerinden farklı. Örneğin, Örneğin, bir restoran arabayla çalışma saatlerini veya adrese teslim saatini ikincil çalışma saatleri olarak ayarlayacağız. |
paymentOptions |
Mağazanın kabul ettiği ödeme seçenekleri. Bir yer,
tek ödeme seçeneğidir. Ödeme seçeneği verileri mevcut değilse
ödeme seçeneği alanı ayarlanmaz. Seçenekler aşağıdakileri içerir:
|
parkingOptions |
Yerin sunduğu park seçenekleri. Seçenekler aşağıdakileri içerir:
|
subDestinations |
Belirli bir yerle ilgili benzersiz yerler. Örneğin, havaalanı terminalleri, bir işletmenin görebilirsiniz. |
fuelOptions |
Şurada mevcut yakıt seçenekleriyle ilgili en güncel bilgiler:
benzin istasyonu. Bu bilgiler düzenli olarak güncellenir. Seçenekler şunları içerir:
şunlar:
|
evChargeOptions |
Bu istasyondaki elektrikli araç (EV) şarj noktası sayısı. Bu sırada bazı EV şarj cihazlarının birden fazla konnektörü vardır, her şarj cihazı yalnızca Her seferinde bir aracı şarj edin; sonuç olarak bu alan belirli bir anda kullanılabilir EV şarj noktalarının sayısı. |
shortFormattedAddress |
Bir yerin kısa, kullanıcılar tarafından okunabilen adresi. |
primaryType |
Belirli bir sonucun birincil türü. Örneğin, bir yer
cafe veya airport olarak sınıflandırılmalıdır. CEVAP
yer yalnızca tek bir birincil türe sahip olabilir.
olası değerlere bakın. Desteklenen türler bölümüne bakın. |
primaryTypeDisplayName |
Birincil türün, isteğe yerelleştirilmiş görünen adı dil ayarını seçin. 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ı vardır. |
liveMusic |
Mekan, canlı müzik performanslarına sahne oluyor. |
menuForChildren |
Yerde çocuk menüsü vardır. |
servesCocktails |
Bu yerde kokteyl servisi vardır. |
servesDessert |
Burada tatlı servisi var. |
servesCoffee |
Bu yerde kahve servisi var. |
goodForChildren |
Yer çocuklar için uygun. |
allowsDogs |
Yer köpeklere izin verir. |
restroom |
Bu yerde tuvalet var. |
goodForGroups |
Yer, gruplar barındırıyor. |
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 |
Otelde tekerlekli sandalyeye uygun otopark mevcuttur. |
wheelchairAccessibleEntrance |
Yerin tekerlekli sandalyeye uygun girişi vardır. |
wheelchairAccessibleRestroom |
Bu yerde tekerlekli sandalyeye uygun tuvalet var. |
wheelchairAccessibleSeating |
Yerde tekerlekli sandalyeye uygun oturma alanı vardır. |
New Places API'lerine geçiş yapın
Mevcut bir Places API müşterisiyseniz ve uygulamanızı aşağıdaki taşıma dokümanlarını inceleyin: