<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 07:39:51 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[DOCS-934] Multiple $centerSphere examples are wrong and related issues with $within and $centerSphere</title>
                <link>https://jira.mongodb.org/browse/DOCS-934</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;h4&gt;&lt;a name=&quot;%24centerSphereexampleswrong&quot;&gt;&lt;/a&gt;$centerSphere examples wrong&lt;/h4&gt;

&lt;p&gt;The geo query operator &lt;tt&gt;$centerSphere&lt;/tt&gt; is the spherical (3D) equivalent to &lt;tt&gt;$center&lt;/tt&gt; (2D). Both are meant to be used with the &lt;tt&gt;$within&lt;/tt&gt; operator (unlike for example $near or $nearSphere).&lt;/p&gt;

&lt;p&gt;All references to &lt;tt&gt;$centerSphere&lt;/tt&gt; in the docs I could find so far use a wrong example:&lt;/p&gt;

&lt;p/&gt;
&lt;div id=&quot;syntaxplugin&quot; class=&quot;syntaxplugin&quot; style=&quot;border: 1px dashed #bbb; border-radius: 5px !important; overflow: auto; max-height: 30em;&quot;&gt;
&lt;table cellspacing=&quot;0&quot; cellpadding=&quot;0&quot; border=&quot;0&quot; width=&quot;100%&quot; style=&quot;font-size: 1em; line-height: 1.4em !important; font-weight: normal; font-style: normal; color: black;&quot;&gt;
		&lt;tbody &gt;
				&lt;tr id=&quot;syntaxplugin_code_and_gutter&quot;&gt;
						&lt;td  style=&quot; line-height: 1.4em !important; padding: 0em; vertical-align: top;&quot;&gt;
					&lt;pre style=&quot;font-size: 1em; margin: 0 10px;  margin-top: 10px;   margin-bottom: 10px;  width: auto; padding: 0;&quot;&gt;&lt;span style=&quot;color: black; font-family: &apos;Consolas&apos;, &apos;Bitstream Vera Sans Mono&apos;, &apos;Courier New&apos;, Courier, monospace !important;&quot;&gt;db.collection.find( { loc: { $centerSphere: { [0,0], 10 / 3959 } } } )&lt;/span&gt;&lt;/pre&gt;
			&lt;/td&gt;
		&lt;/tr&gt;
			&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p/&gt;


&lt;p&gt;Instead, the example should read:&lt;/p&gt;

&lt;p/&gt;
&lt;div id=&quot;syntaxplugin&quot; class=&quot;syntaxplugin&quot; style=&quot;border: 1px dashed #bbb; border-radius: 5px !important; overflow: auto; max-height: 30em;&quot;&gt;
&lt;table cellspacing=&quot;0&quot; cellpadding=&quot;0&quot; border=&quot;0&quot; width=&quot;100%&quot; style=&quot;font-size: 1em; line-height: 1.4em !important; font-weight: normal; font-style: normal; color: black;&quot;&gt;
		&lt;tbody &gt;
				&lt;tr id=&quot;syntaxplugin_code_and_gutter&quot;&gt;
						&lt;td  style=&quot; line-height: 1.4em !important; padding: 0em; vertical-align: top;&quot;&gt;
					&lt;pre style=&quot;font-size: 1em; margin: 0 10px;  margin-top: 10px;   margin-bottom: 10px;  width: auto; padding: 0;&quot;&gt;&lt;span style=&quot;color: black; font-family: &apos;Consolas&apos;, &apos;Bitstream Vera Sans Mono&apos;, &apos;Courier New&apos;, Courier, monospace !important;&quot;&gt;db.collection.find( { loc: { $within: { $centerSphere: [ [0,0], 10 / 3959 ] } } } )&lt;/span&gt;&lt;/pre&gt;
			&lt;/td&gt;
		&lt;/tr&gt;
			&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p/&gt;

&lt;p&gt;Note there are two differences:&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;the additional &lt;tt&gt;$within&lt;/tt&gt;&lt;/li&gt;
	&lt;li&gt;Using an array instead of a document as the value for &lt;tt&gt;$centerSphere&lt;/tt&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;These are the links I found so far that need to be changed:&lt;br/&gt;
&lt;a href=&quot;http://docs.mongodb.org/manual/reference/operator/centerSphere/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://docs.mongodb.org/manual/reference/operator/centerSphere/&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;http://docs.mongodb.org/manual/core/geospatial-indexes/#distance-calculation&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://docs.mongodb.org/manual/core/geospatial-indexes/#distance-calculation&lt;/a&gt;&lt;br/&gt;
&lt;a href=&quot;http://docs.mongodb.org/manual/reference/operators/#_S_centerSphere&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;http://docs.mongodb.org/manual/reference/operators/#_S_centerSphere&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;There may be other references that I couldn&apos;t find.&lt;/p&gt;

&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;
&lt;h4&gt;&lt;a name=&quot;%24withindocsdon%27tmention%24centerSphere&quot;&gt;&lt;/a&gt;$within docs don&apos;t mention $centerSphere&lt;/h4&gt;
&lt;p&gt;In addition, the &lt;a href=&quot;http://docs.mongodb.org/manual/reference/operator/within/#within&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;docs on &lt;tt&gt;$within&lt;/tt&gt;&lt;/a&gt; say they only support &lt;b&gt;three&lt;/b&gt; shapes: &lt;tt&gt;$box&lt;/tt&gt;, &lt;tt&gt;$center&lt;/tt&gt;, &lt;tt&gt;$polygon&lt;/tt&gt;. They should also mention the fourth one, &lt;tt&gt;$centerSphere&lt;/tt&gt; with appropriate example.&lt;/p&gt;

&lt;p&gt;&lt;br class=&quot;atl-forced-newline&quot; /&gt;&lt;/p&gt;
&lt;h4&gt;&lt;a name=&quot;Operatorsreferencepageorderingisconfusing&quot;&gt;&lt;/a&gt;Operators reference page ordering is confusing&lt;/h4&gt;
&lt;p&gt;Lastly, the &lt;a href=&quot;http://docs.mongodb.org/manual/reference/operators/#geospatial&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;operators page&lt;/a&gt; lists all the different operators, but the order is confusing. It mentions &lt;tt&gt;$near&lt;/tt&gt;, then &lt;tt&gt;$within&lt;/tt&gt;, and much further below &lt;tt&gt;$nearSphere&lt;/tt&gt; and &lt;tt&gt;$centerSphere&lt;/tt&gt;. This needs to be cleaned up as well.&lt;/p&gt;

&lt;p&gt;The hierarchy should be:&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;&lt;tt&gt;$near&lt;/tt&gt;&lt;/li&gt;
	&lt;li&gt;&lt;tt&gt;$nearSphere&lt;/tt&gt;&lt;/li&gt;
&lt;/ul&gt;


&lt;ul&gt;
	&lt;li&gt;&lt;tt&gt;$within&lt;/tt&gt;
	&lt;ul&gt;
		&lt;li&gt;&lt;tt&gt;$center&lt;/tt&gt;&lt;/li&gt;
		&lt;li&gt;&lt;tt&gt;$centerSphere&lt;/tt&gt;&lt;/li&gt;
		&lt;li&gt;&lt;tt&gt;$box&lt;/tt&gt;&lt;/li&gt;
		&lt;li&gt;&lt;tt&gt;$polygon&lt;/tt&gt;&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
&lt;/ul&gt;


</description>
                <environment></environment>
        <key id="60761">DOCS-934</key>
            <summary>Multiple $centerSphere examples are wrong and related issues with $within and $centerSphere</summary>
                <type id="1" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14703&amp;avatarType=issuetype">Bug</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="9">Done</resolution>
                                        <assignee username="bgrabar">Bob Grabar</assignee>
                                    <reporter username="thomas.rueckstiess@mongodb.com">Thomas Rueckstiess</reporter>
                        <labels>
                    </labels>
                <created>Thu, 3 Jan 2013 01:35:27 +0000</created>
                <updated>Mon, 30 Oct 2023 21:57:48 +0000</updated>
                            <resolved>Thu, 14 Feb 2013 20:57:02 +0000</resolved>
                                                    <fixVersion>Server_Docs_20231030</fixVersion>
                                    <component>manual</component>
                        <due></due>
                            <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="267160" author="auto" created="Fri, 15 Feb 2013 15:22:49 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;date&apos;: u&apos;2013-01-14T21:34:03Z&apos;, u&apos;name&apos;: u&apos;Bob Grabar&apos;, u&apos;email&apos;: u&apos;bob.grabar@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-934&quot; title=&quot;Multiple $centerSphere examples are wrong and related issues with $within and $centerSphere&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-934&quot;&gt;&lt;del&gt;DOCS-934&lt;/del&gt;&lt;/a&gt; review edits&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/82861e1be3e5a32e10848ac6e7c974792d6c44e1&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/82861e1be3e5a32e10848ac6e7c974792d6c44e1&lt;/a&gt;&lt;/p&gt;</comment>
                            <comment id="267159" author="auto" created="Fri, 15 Feb 2013 15:22:47 +0000"  >&lt;p&gt;Author:&lt;/p&gt;
{u&apos;date&apos;: u&apos;2013-01-11T02:54:49Z&apos;, u&apos;name&apos;: u&apos;Bob Grabar&apos;, u&apos;email&apos;: u&apos;bob.grabar@10gen.com&apos;}
&lt;p&gt;Message: &lt;a href=&quot;https://jira.mongodb.org/browse/DOCS-934&quot; title=&quot;Multiple $centerSphere examples are wrong and related issues with $within and $centerSphere&quot; class=&quot;issue-link&quot; data-issue-key=&quot;DOCS-934&quot;&gt;&lt;del&gt;DOCS-934&lt;/del&gt;&lt;/a&gt; centerSphere and within&lt;br/&gt;
Branch: master&lt;br/&gt;
&lt;a href=&quot;https://github.com/mongodb/docs/commit/cff05b3dc0c203c483e997bea7e712eede9a3054&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/docs/commit/cff05b3dc0c203c483e997bea7e712eede9a3054&lt;/a&gt;&lt;/p&gt;</comment>
                    </comments>
                <issuelinks>
                            <issuelinktype id="10010">
                    <name>Duplicate</name>
                                            <outwardlinks description="duplicates">
                                        <issuelink>
            <issuekey id="52878">DOCS-597</issuekey>
        </issuelink>
                            </outwardlinks>
                                                                <inwardlinks description="is duplicated by">
                                        <issuelink>
            <issuekey id="63599">DOCS-1065</issuekey>
        </issuelink>
                            </inwardlinks>
                                    </issuelinktype>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                                                <inwardlinks description="is related to">
                                                        </inwardlinks>
                                    </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Thu, 10 Jan 2013 22:03:56 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        11 years, 5 days ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></customfieldvalue>


                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>emet.ozar@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            11 years, 5 days ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>auto</customfieldvalue>
            <customfieldvalue>bgrabar</customfieldvalue>
            <customfieldvalue>thomas.rueckstiess@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrs4nz:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hrlbev:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>38210</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hrygu7:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                </customfields>
    </item>
</channel>
</rss>