Yer Ayrıntıları (Yeni)

Platform seçin: Android iOS JavaScript Web Hizmeti

Yer kimliğiniz olduktan sonra şunları yapabilirsiniz: belirli bir kurum hakkında daha fazla bilgi talep etmek veya önemli bir noktayı gösteren Yer Ayrıntıları (Yeni) isteğinde bulunabilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yer hakkında daha kapsamlı bilgiler döndürür tam adresi, telefon numarası, kullanıcı puanı ve yorumları gibi.

Yer kimliğini almanın birçok yolu vardır. Şunları kullanabilirsiniz:

API Gezgini, API'yi ve sunulan API'yi tanıyabilmeniz için canlı isteklerde bulunmanızı sağlar. API seçenekleri:

Deneyin.

Yer Ayrıntıları (Yeni) istekleri

Yer Ayrıntıları isteği, formdaki bir HTTP GET isteğidir:

https://places.googleapis.com/v1/places/PLACE_ID

Tüm parametreleri GET isteği. Örneğin:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Alternatif olarak bir cURL komutunda:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Yer Ayrıntıları (Yeni) yanıtları

Yer Ayrıntıları (Yeni), Yanıt olarak JSON nesnesi. Yanıtta:

  • Yanıt, bir Place nesnesini tanımlayın. Place nesnesi, yer.
  • İstekte iletilen FieldMask, alanların listesini belirtir Place nesnesinde döndürülür.

JSON nesnesinin tamamı aşağıdaki biçimdedir:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Gerekli parametreler

  • FieldMask

    Bir yanıt alanı maskesi oluşturun. URL parametresini kullanarak yanıt alanı maskesini yönteme iletin $fields veya fields ya da HTTP üstbilgisi kullanarak X-Goog-FieldMask. Yanıtta varsayılan bir döndürülen alan listesi yok. Alan maskesini çıkarırsanız yöntem hata döndürür.

    Alan maskeleme, bir kullanıcının sizden başka bir alan adına Böylece, gereksiz işlem süresini ve faturalandırma ücretleri.

    Döndürülecek yer verisi türlerinin virgülle ayrılmış listesini belirtin. Örneğin, Google Etiket Yöneticisi'ni kullanarak yerin görünen adını ve adresini alın.

    X-Goog-FieldMask: displayName,formattedAddress
    .

    Tüm alanları almak için * öğesini kullanın.

    X-Goog-FieldMask: *
    .

    Aşağıdaki alanlardan birini veya daha fazlasını belirtin:

    • Aşağıdaki alanlar Yer Ayrıntıları (Yalnızca Kimlikler) SKU'sunu tetikler:

      attributions, id, name*, photos

      * name alanında yer kaynak adı yer alır form: places/PLACE_ID. displayName hesabını kullan yerin metin adına erişmek için tıklayın.

    • Aşağıdaki alanlar Yer Ayrıntıları (Yalnızca Konum) SKU'sunu tetikler:

      addressComponents, adrFormatAddress, formattedAddress, location, plusCode, shortFormattedAddress, types, viewport

    • Aşağıdaki alanlar Yer Ayrıntıları (Temel) SKU'sunu tetikler:

      accessibilityOptions, businessStatus, displayName, googleMapsUri, iconBackgroundColor, iconMaskBaseUri, primaryType, primaryTypeDisplayName, subDestinations, utcOffsetMinutes

    • Aşağıdaki alanlar Yer Ayrıntıları (Gelişmiş) SKU'sunu tetikler:

      currentOpeningHours, currentSecondaryOpeningHours, internationalPhoneNumber, nationalPhoneNumber, priceLevel, rating, regularOpeningHours, regularSecondaryOpeningHours, userRatingCount, websiteUri

    • Aşağıdaki alanlar Yer Ayrıntıları (Tercih Edilen) SKU'sunu tetikler:

      allowsDogs, curbsidePickup, delivery, dineIn, editorialSummary, evChargeOptions, fuelOptions, goodForChildren, goodForGroups, goodForWatchingSports, liveMusic, menuForChildren, parkingOptions, paymentOptions, outdoorSeating, reservable, restroom, reviews, servesBeer, servesBreakfast, servesBrunch, servesCocktails, servesCoffee, servesDessert, servesDinner, servesLunch, servesVegetarianFood, servesWine, takeout

  • placeId

    Bir araçtan alınan, bir yeri benzersiz şekilde tanımlayan metinsel bir tanımlayıcı Metin Arama (Yeni) veya Yakında Arama (Yeni). Yer kimlikleri hakkında daha fazla bilgi için bkz. yer kimliğine genel bakış.

    places/PLACE_ID dizesi bu yer olarak da adlandırılır kaynak adı. Yer Ayrıntılarından (Yeni) aldığımız yanıtta, Yakındaki Arama (Yeni) ve Metin Arama (Yeni) bu dize, yanıtın name alanında yer alır. Bağımsız yer kimliği, yanıtın id alanında yer alır.

İsteğe bağlı parametreler

  • languageCode

    Sonuçların döndürüleceği dil.

    • Bkz. desteklenen dillerin listesini inceleyin. Google genellikle Bu nedenle bu liste tam kapsamlı olmayabilir.
    • languageCode sağlanmazsa API varsayılan olarak en olur. Eğer geçersiz bir dil kodu belirtirseniz API, INVALID_ARGUMENT hatası verir.
    • API, okunabilir bir açık adres sağlamak için elinden geleni yapar: dahil edilir. Bu hedefe ulaşmak için sokakları yerel dildeki adreslerin harf çevirisi yapılarak okunabilir bir (gerekirse, tercih edilen dili gözeterek) kullanıcı. Diğer tüm ülkeler tercih edilen dilde döndürülür. Adres bileşenleri tümü aynı dilde döndürülür; bu, ilk dilden bir bileşenidir.
    • Bir ad tercih edilen dilde sunulmuyorsa API, en yakın eşleşmedir.
    • Tercih edilen dilin, arama sonuçlarında görünen döndürmeyi seçtiği sıra ve bunların döndürülme sırasına göre belirlenir. İlgili içeriği oluşturmak için kullanılan coğrafi kod, kısaltmaları dile bağlı olarak farklı şekillerde yorumlar, Örneğin sokak türlerinin kısaltmalarını veya başka bir dilde geçerli olmayabilir.

  • regionCode

    Yanıtı biçimlendirmek için kullanılan bölge kodu, CLDR kodu değerini girin. Varsayılan bir değer yok.

    Yanıttaki formattedAddress alanının ülke adı regionCode, ülke kodu formattedAddress öğesinden atlanır. Bu parametrenin, her zaman ülkeyi içeren adrFormatAddress üzerinde etkisi yoktur. adı veya hiçbir zaman içermeyen shortFormattedAddress üzerinde.

    Çoğu CLDR kodu ISO 3166-1 kodlarıyla aynıdır. bazı önemli istisnalarla birlikte. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu "gb" ise (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı"). Parametre, geçerli yasalara göre sonuçları etkileyebilir.

  • sessionToken

    Oturum jetonları Otomatik Tamamlama'yı izleyen kullanıcı tarafından oluşturulmuş dizelerdir (Yeni) aramaları "oturumlar" olarak adlandırılır. Otomatik Tamamlama (Yeni), şunları yapmak için oturum jetonlarını kullanır: bir kullanıcı otomatik tamamlama aramasının sorgu ve yer seçimi aşamalarını ayrı bir oturumda gruplandırmak . Oturum jetonları Yer Ayrıntılarına aktarılır (Yeni) Otomatik tamamlama (Yeni) aramalarını takip eden aramalar Daha fazla bilgi için bkz. Oturum jetonları.

Yer Ayrıntıları örneği

Aşağıdaki örnekte bir yerin ayrıntılarına ilişkin bilgiler istenmektedir. placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

X-Goog-FieldMask üstbilgisinin yanıt şu veri alanlarını içerir: id,displayName. Bu durumda yanıt şu biçimde olur:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Ek bilgiler döndürmek için alan maskesine daha fazla veri türü ekleyin. Örneğin, formattedAddress,plusCode adresini ve Plus Code'u yanıt:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Yanıt artık şu formda:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Deneyin!

API Gezgini sayesinde örnek isteklerde bulunabilirsiniz. hakkında da bilgi edineceksiniz.

İstekte bulunmak için:

  1. API simgesini, API Gezgini'ni genişletin. sekmesini tıklayın.
  2. İsteğe bağlı olarak name parametresini şu şekilde ayarlayın: 
    places/PLACE_ID
  3. İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve fields parametresi alan maskesine benzer.
  4. Yürüt düğmesini seçin. Pop-up pencerede, kullanmaları gerekir.

  5. API Gezgini panelinde genişlet simgesini seçin, API Gezgini penceresini genişletmek için API Gezgini'ni genişletin. tuşlarına basın.