Giriş
Yer Ayrıntıları (Yeni),
Yakında Arama (Yeni)
ve
Text Search (Yeni)
API'lerinin yanıt biçimi, eski API'lerin biçiminden farklıdır. Temel fark, Yanıt Place nesnesinde yapılan değişiklikler bölümünde açıklandığı gibi, her yöntemin döndürdüğü Place nesnesinin biçimindedir.
Ayrıca, yanıt nesnesinin üst düzey alanları da her API için değişti. Şu konulara göz atın:
- Text Search yanıt değişiklikleri
- Yakında Arama yanıtındaki değişiklikler
- Yer Ayrıntıları yanıt değişiklikleri
Yanıt Place nesnesinde yapılan değişiklikler
Bu tabloda, Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) yanıtındaki yeni Place nesnesinde yapılan değişiklikler, eski Place nesnesiyle karşılaştırılarak gösterilmektedir.
Yeni yanıt nesnesi, alan adları için camel case kullanır, yeni alanlar içerir ve eski alanlardan bazılarını yeniden adlandırır.
| Alan | Places API (Eski) nesnesi | Places API (Yeni) nesnesi | Notlar |
|---|---|---|---|
| Adres bileşeni | address_components |
addressComponents |
|
| Yer mikro biçim adresi | adr_address |
adrFormatAddress |
|
| İşletmenin durumu | business_status |
businessStatus |
|
| Gelecek haftanın çalışma saatleri | current_opening_hours |
currentOpeningHours |
|
| İçerik özeti | editorial_summary |
editorialSummary |
|
| Biçimlendirilmiş adres | formatted_address |
formattedAddress |
|
| Ulusal telefon numarası | formatted_phone_number |
nationalPhoneNumber |
|
| Konum | geometry.location |
location |
|
| Görüntü alanı | geometry.viewport |
viewport |
|
| Yer ilişkilendirmeleri | html_attributions |
attributions |
Eski API'lerde yanıtın üst düzey alanı |
| Simge URL'si | icon |
Kaldırıldı. iconMaskBaseUri ve iconBackgroundColor kullanın. Daha fazla bilgi için Yer simgeleri bölümüne bakın. |
|
| Simge arka plan rengi | icon_background_color |
iconBackgroundColor |
|
| Simge maskesi URL'si | icon_mask_base_uri |
iconMaskBaseUri |
|
| Uluslararası telefon numarası | international_phone_number |
internationalPhoneNumber |
|
| Metin yer adı | name |
displayName |
Metin yer adı artık displayName.text ve language olarak displayName.languageCode olarak erişilebilir. |
| Çalışma saatleri | opening_hours |
regularOpeningHours |
|
| Fotoğraflar | photos |
photos |
photos biçimi yeni Place nesnesinde değişti. Daha fazla bilgi için Fotoğraf referanslarında değişiklik başlıklı makaleyi inceleyin. |
| Yer kimliği | place_id |
id |
|
| Plus code | plus_code |
plusCode |
|
| Fiyat düzeyi | price_level |
priceLevel |
|
| Derecelendirme | rating |
rating |
|
| Yorumlar | reviews |
reviews |
|
| Bugünden itibaren önümüzdeki hafta için ikincil çalışma saatleri (istisnalar ve diğer tüm verilerle birlikte) | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Yer türleri | types |
types |
|
| Yerin Google Haritalar URL'si | url |
googleMapsUri |
|
| Kullanıcı puanı sayısı | user_ratings_total |
userRatingCount |
|
| UTC farkı | utc_offset |
utcOffsetMinutes |
|
| Sokak adı ve ilçeyi içeren kısa adres | vicinity |
shortFormattedAddress |
|
| Yerin web sitesi | website |
websiteUri |
|
| Tekerlekli sandalye kullanıcılarına uygunluk bilgileri | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance artık accessibilityOptions.wheelchairAccessibleEntrance |
| Yer özellikleri | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| Kaynak adı | places/PLACE_ID formundaki name alanı |
Eski API'de name alanı, yer adını metin dizesi olarak içeriyordu. Yeni API'de bu bilgiler displayName alanında yer alır. |
|
| Yerin birincil türü | primaryTypeName |
Yeni | |
| Birincil türü metin dizesi olarak yerleştirin. | primaryTypeDisplayName |
Yeni | |
| İstisnalar ve diğer tüm verilerle birlikte düzenli haftalık ikincil çalışma saatleri | regularSecondaryOpeningHours |
Yeni | |
| Yerin kabul ettiği ödeme seçenekleri | paymentOptions |
Yeni | |
| Yerin otopark seçenekleri | parkingOptions |
Yeni | |
| Yerle ilgili alt hedeflerin listesi | subDestinations |
Yeni | |
| Benzin istasyonundaki yakıt seçenekleri hakkında en güncel bilgiler | fuelOptions |
Yeni | |
| Bir yerle ilgili elektrikli araç şarj bilgileri | evChargeOptions |
Yeni | |
| Yer özellikleri | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Yeni |
Text Search yanıt değişiklikleri
Aşağıdaki tabloda, Text Search (Eski) için yanıt nesnesinin ve Text Search (Yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API'de, yanıttaki tek üst düzey alan places dizisidir.
| Alan | Text Search (Eski) | Metin Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Her yer için yeni Place nesnesine place.attributions olarak taşındı. |
|
| Yer dizisi | Eski Place nesnesinin results dizisi |
Yeni Place nesnesinin places dizisi |
|
| Talebin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yakında Arama yanıtındaki değişiklikler
Aşağıdaki tabloda, Yakında Arama (Eski) için yanıt nesnesinin ve Yakında Arama (Yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API'de, yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yakında Arama (Eski) | Yakında Arama (Yeni) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Her yer için yeni Place nesnesine place.attributions olarak taşındı. |
|
| Yer dizisi | Eski Place nesnesinin results dizisi |
Yeni Place nesnesinin places dizisi |
|
| Talebin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Hata mesajları | error_message |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm bilgi mesajları | info_messages |
Kaldırıldı | |
| Sayfa jetonu | next_page_token |
Kaldırıldı |
Yer Ayrıntıları (Yeni) yanıt değişiklikleri
Aşağıdaki tabloda, Yer Ayrıntıları (Eski) için yanıt nesnesinin ve Yer Ayrıntıları (Yeni) için yanıt nesnesinin üst düzey alanlarında yapılan değişiklikler gösterilmektedir. Yeni API'de, yanıttaki tek üst düzey alan places dizisidir.
| Alan | Yer Ayrıntıları (Eski) | Place Details (New) | Notlar |
|---|---|---|---|
| Yer ilişkilendirmeleri | html_attributions |
Yeni Place nesnesine attributions olarak taşındı |
|
| Place Details (New) | Eski Place nesnesini içeren result |
Yeni Place nesnesi | |
| Talebin durumu | status |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı | |
| Tüm bilgi mesajları | info_messages |
Standart HTTP yanıtına (HTTP yanıt kodu ve mesajı) taşındı |