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 bir 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ı. Place Photo (Yeni) API'yi kullanarak fotoğraflara erişebilir ve resmi uygulamanız için en uygun boyuta 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ı (Yeni), Metin Arama (Yeni) veya Yakındakiler 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ındaki Arama (Yeni)
Yerler API'si iki arama API'si içerir:
-
Bir yer aranacak metin dizesini belirtmenize olanak tanır. Örneğin: "Sidney, Avustralya'da baharatlı vejetaryen yemekler" veya "Palo Alto, CA yakınlarında lüks deniz ürünleri restoranı".
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 enlem ve boylam değerleriyle tanımlanan bir daire olarak belirtin merkez noktasının ve yarıçapın metre cinsinden koordinatları.
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.
İ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, 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 yönleri 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şlemlerin belirli zamanlarını açıklar. İkincil çalışma saatleri, işletmenin ana çalışma saatlerinden farklıdır. Ö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 birden fazla ödeme seçeneğini kabul edebilir. Ödeme seçeneği verileri mevcut değilse
ödeme seçeneği alanı ayarlanmaz. Seçenekler şunlardır:
|
parkingOptions |
Yerin 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 ş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 aynı anda 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 ve okunabilir adresi. |
primaryType |
Belirli bir sonucun birincil türü. Örneğin, bir yer
cafe veya airport olarak sınıflandırılmalıdır. 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), çeşitli yeni özellikler 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 |
Burada kokteyl servisi var. |
servesDessert |
Tatlı servisi var. |
servesCoffee |
Bu yerde kahve servisi var. |
goodForChildren |
Yer çocuklar için uygun. |
allowsDogs |
Tesiste köpeklere izin veriliyor. |
restroom |
Tesiste tuvalet var. |
goodForGroups |
Yer, grupları barındırabilir. |
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 |
Yerin tekerlekli sandalyeye uygun girişi vardır. |
wheelchairAccessibleRestroom |
Bu yerde tekerlekli sandalyeye uygun tuvalet var. |
wheelchairAccessibleSeating |
Yerde tekerlekli sandalyeye uygun oturma alanı var. |
Yeni Places API'lerine geçiş
Mevcut bir Places API müşterisiyseniz ve uygulamanızı yeni API'leri kullanacak şekilde taşımak istiyorsanız aşağıdaki taşıma dokümanlarına bakın: